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On first thought, it might seem strange that another book on the 8080 and 
Z-80 should appear at this time. Z-80 CPU cards generally became available 
in 1977 and the 8080 CPU is even older. But the Z-80 computer seems to 
become more popular with time. For example, the TRS-80 Model II an- 
nounced recently by Radio Shack, and Heath’s H-89 both use the CPU. | 
High-level languages such as Pascal, APL, BASIC, FORTRAN, and C are now | 
run on the 8080 and Z-80. Furthermore, Microsoft has available a Z-80 CPU 
card that can be easily inserted into the Apple II computer. There should be 
an increasing interest in the 8080 and Z-80 CPUs in the coming years, and I 
believe, a great increase in the number of 8080 and Z-80 programmers. So, © 
there is a growing need for a book that covers programming for the 8080 
and Z-80 assembly languages. 

The combination of 8080 and Z-80 programming concepts into a single 
work is quite natural. The Z-80 CPU is upward compatible from the 8080 
so that all commercially available 8080 software will run on the Z-80. 
Furthermore, 8080 assemblers, such as ASM provided with CP/M, can be 
used to create programs that will run on either an 8080 system or a Z-80 
system. 

The purpose of this book is twofold. First, I want to provide a single 
reference source for both 8080 and Z-80 assembly language programmers. 
The appendixes are designed with this goal in mind. They begin with the 
ASCII character set and a 64K memory map. These two appendixes are as 
useful to those using higher level languages as they are to assembly language 
programmers. 

The 8080 and Z-80 instruction sets are listed both alphabetically and 
numerically in the next four appendixes. This is followed by a cross refer- 


ence between the 8080 and the Z-80 mnemonics. An appendix describing _ 


each instruction in detail then follows. Common acronyms are identified 
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next in Appendix I, and some undocumented Z-80 instructions are dis- 
cussed in the final appendix. Collectively, the appendixes contain all of the 
reference material needed to write 8080 or Z-80 assembly language programs. 

The second purpose of this work is to demonstrate some useful tech- 
niques of assembly language programming. As an editor for Interface Age, | 
have seen numerous examples of inefficient or improper programming. 
General principles of assembly language programming are discussed in 
Chapters One through Five; specific programming examples are given in 
Chapters Five through Ten. The reader can actually assemble the programs 
and try them out. 

The organization and operation of the 8080 and Z-80 CPUs is covered 
in Chapter One. This includes a discussion of the general-purpose registers, 
the flag registers, logical operations, branching, double-register operations, 
rotation and shifting. The concepts of hexadecimal, octal, and binary num- 
bers, one’s and two’s complement arithmetic, and the use of logical opera- 
tions are presented in Chapter Two. 

Stack operations with PUSH, POP, CALL and RET commands and the 
passing of data between calling program and subroutine are given in Chapter 
Three. Chapter Four is devoted to input and output techniques, including 
an interrupt-dirven keyboard routine and a telephone transmission program. 
Assembler macros are discussed in Chapter Five. Examples show how to 
generate Z-80 instructions with an 8080 macro assembler, and how to emu- 
late Z-80 instructions on an 8080 CPU. 

The reader can develop a small, powerful monitor in Chapter Six using 
the top-down programming method. The monitor contains the usual com- 
mands of dump, load, and go. In addition, there is a memory test, a routine 
to search for one or two hex bytes or ASCII characters, a routine to replace 
all occurrences of one byte with another, and a routine to perform input 

and output through any port. . 
In Chapter Seven the monitor is converted to Z-80 instructions and 
some additional features are added. Assembly-language subroutines for inter- 
converting between binary numbers and ASCII characters coded in one of 
the common number bases are given in Chapter Hight. These routines per- 
form all of the input and output through the system monitor developed in 
Chapter Six. Paper tape and magnetic tape routines are given in Chapter 
Nine. This method of data transfer is still very popular. I frequently am 
asked to read information on paper tape into our Z-80 computer so that it 
can be transmitted over the telephone line to our campus Dec-20 computer. 

CP/M is currently the most popular 8080/Z-80 operating system. 
Chapter Ten demonstrates how assembly language programs can utilize CP/M 
for all input and output by presenting three programs. One of these pro- 
grams allows the user to branch to any address from the system level. Never- 
theless, the use of CP/M is not the subject of this book. More information on 
the use of the CP/M operating system can be obtained from Using CP/M: A 
Self-Teaching Guide by Judi Fernandez and Ruth Ashley (John Wiley and 
Sons, Inc., 1980). 
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The assembly language programs in this book have all been assembled 
on an Altair 8800, with an Ithaca Z-80 CPU card and North Star double- 
density disks. The Lifeboat 2.0 version of CP/M was used as the operating 
system. The system monitor given in Chapter Six was additionally pro- 
grammed to run on a TRS-80 Model II, using a Lifeboart 2,2 version CP/M 
operating system. The alternate version of the input and output routines was 
used in this case. The Digital Research assembler MAC was used for the 8080 
instructions and the Microsoft assembler MACRO-80 was used for the Z-80 
code. All of the assembly listings have been reproduced directly from the 
original computer printouts. The manuscript was created and edited with 
MicroPro’s Word-Master and formatted with Organic Software’s Textwriter. 

Thanks to Heidi for typing the manuscript. Also, I should like to 
acknowledge the programmers at Microsoft, Digital Research, and Lifeboat _ 
Associates for the many things they have taught me about programming. . 


Alan R. Miller 
June 1980 


Contents 


Chapter One 


Chapter Two 


Chapter Three 


Introduction He 
The 8080 CPU, 3 

The Memory Register, 5 

The Flag Register, 5 

Flags and Arithmetic Operations, 6 

Flags and Logical Operations, 7 

Increment, Decrement, and Rotate Instructions, 8 
Rotation of Bits in the Accumulator, 9 

Flags and Double-Register Operations, 10 

The Z-80 CPU,10 | 

Z-80 Relative Jumps, 12 

Z-80 Double-Register Operations, 13 

Z-80 Input and Output (I/O) Instructions, 14 
Shifting Bits, 14 


Number Bases and Logical Operations 16 

Number Representation in Binary, BCD, 
and ASCII, 19 

Logical Operations, 20 

The Two’s Complement, 21 

Logical OR and Logical AND, 23 

Setting a Bit with Logical OR, 24 

Resetting a Bit with Logical AND, 25 

Logical Exclusive OR, 26 

Logical NAND and NOR gates, 26 

Making Other Gates, 28 


The Stack; 30 
Storing Data on the Stack, 31 
The aoe and PSW as a Double Reastiee 34 


vii 


Chapter Four 


Chapter Five 


Chapter Six 


Z-80 Index Registers, 35 

Subroutine Calls, 35 

Passing Data Improperly to a Subroutine, 37 
Passing Data Properly to a Subroutine, 37 
Passing Data Back from a Subroutine, 39 
Setting up a New Stack, 40 

Calling a Subroutine in Another Program, 41 
Calling One Subroutine from Another, 42 
Bypassing a Subroutine on Return, 43 

A PUSH Without a POP, 44 

Getting Back from a Subroutine, 44 
Automatic Stack Placement, 45 


Input and Output 

Memory-Mapped I/O, 48 

Distinct Data Ports, 49 

Looping, 50 

Polling, 52 

Hardware Interrupts, 52 

An Interrupt-Drive Keyboard, 55 
Scroll Control and Task Abortion, 64 
Data Transmission by Telephone, 64 
Parity Checking, 66 


Macros 
Generating Three Output Routines with 
One Macro, 71 
Generating Z-80 Instructions with an ~ 
8080 Assembler, 73 
Emulating Z-80 Instructions with an 8080 CPU, 75 
The Repeat Macros, 77 
Printing Strings with Macros, 79 


Development of a System Monitor 

Program Development Details, 86 

Version 1: The Input and Output Routines, 87 
Version 2: A Memory Display, 95 

Version 3: A CALL and GO Routine, 100 


Version 4: A Memory-Load Routine, 101 


Version 5: Useful Entry Points, 103 


. Version 6: Automatic Memory Size, 105 


Version 7: Command-Branch Table, 107 

Version 8: Display the Stack Pointer, 109 

Version 9: ZERO and FILL routines, 110 

Version 10: A Block-Move Routine, 111 

Version 11: A Search Routine, 1138 

Version 12: ASCII Load, Search, and Display, 115 


48 


69 


85 


viii 


So CN Neh stnnettnmthunemnseuentt cnet tnnnieeenverenn teenie smsuuinninsinemeuniase 


Chapter Seven 


Chapter Eight 


Version 13: Input and Output to Any Port, 117 
Version 14: Hexadecimal Arithmetic, 119 

Version 15: Memory-Test Program, 120 

Version 16: Replace One Byte with Another, 121 
Version 17: Compare Two Blocks of Memory, 123 
Automatic Execution of the Monitor, 125 


A Z-80 System Monitor 128 
Conversion of the Monitor to Z-80 Mnemonics, 143 : 
Reducing the Monitor Size, 144 

Getting More Free Space, 145 

Peripheral Port Initialization, 146 

Printer Output Routines, 147 

Delay After a Carriage Return, 148 


Number-Base Conversion 150 
The ASCII Code, 150 
Conversion of ASCII-Encoded Binary Characters 

to an 8-Bit Binary Number in Register C, 152 
Conversion of ASCII Decimal Characters 

to a Binary Number, 156 
Conversion of ASCII Hexadecimal Characters 

to a 16-Bit Binary Number In HL, 159 
Conversion of Two ASCII Hexadecimal Characters 

to an 8-Bit Binary Number in Register C, 162 
Conversion of ASCII Octal Characters 

to a 16-Bit Binary Number in Register HL, 163 
Conversion of Three ASCII Octal Characters 

to an 8-Bit Binary Number in Register C, 166 
Conversion of Two ASCII BCD Digits 

to an 8-Bit Binary Number in Register C, 168 
Conversion of an 8-Bit Binary Number in C toa 

String of Eight ASCII Binary Characters, 169 
Conversion of an 8-Bit Binary Number into 

Three ASCII Decimal Characters, 172 
Conversion of a 16-Bit Binary Number into 

Five ASCII Decimal Characters, 175 
Conversion of an 8-Bit Binary Number into 

Two ASCII Hexadecimal Characters, 178 
Conversion of a 16-Bit Binary Number into 

Six ASCII Octal Characters, 180 
Conversion of an 8-Bit Binary Number into 

Three ASCII Octal Characters, 181 
Conversion of a 16-Bit Binary Number 

to Split Octal, 182 


1x’ 


nee esnenamnncaumasinnman me ea EAnet ET NDI EAE CARDEN LACE LE CC CC CLT, 


Chapter Nine 


Chapter 10 


Appendixes 


Index 


UOMO WD 


Paper Tape and Magnetic Tape Routines 
The Checksum Method, 188 

An ASCII-Hex Tape Program, 188 

A Tape-Labeling Routine, 203 

A Binary Tape Monitor, 204 


Linking Programs to the CP/M Operating System 


CP/M Memory Organization, 216 
Changing the Peripheral Assignment, 217 


Incorporating the IOBYTE into Your CBIOS, 219 


Using STAT to Change the IOBYTE, 225 

A Routine to Go Anywhere in Memory, 226 
A List Routine with Date and Time, 229 
Copy a Disk File into Memory, 242 


The ASCII Character Set 

A 64K Memory Map 

The 8080 Instruction Set (Alphabetic) 

The 8080 Instruction Set (Numeric) 

The Z-80 Instruction Set (Alphabetic) 

The Z-80 Instruction Set (Numeric) 
Cross-Reference of 8080 and Z-80 Instructions 


’ Details of the Z-80 and 8080 Instruction Set 


Abbreviations and Acronyms 
Undocumented Z-80 Instructions 


187 


214 


253 
255 
258 
261 
264 
272 
280 
283 
311 
313 


317 


CHAPTER ONE 


Introduction 


There was a time when computers were gigantic machines containing racks 
upon racks of vacuum tubes. The invention of the transistor and the devel- 
opment of the integrated circuit (IC) changed all that. Today, it is possible 
to place tens of thousands of transistors on a single “chip”’ of silicon that is 
smaller than a quarter of an inch square. As a result of this technology. com- 
puters have become smaller and cheaper. 

Computers are commonly classified into three categories, based on size 
and capability. The largest are known as main frame computers, the middle- 
sized ones are called minicomputers, and the smallest are termed microcom- 
puters. A computer consists of three parts: the central processing. unit 
(CPU), the main memory, and the peripherals. 

The CPU directs the activities of the computer by interpreting a set of 
instructions called operation codes, or op codes for short. These instructions 
are located in the main memory. The memory is also used for the storage 
of data. 


The CPU communicates with the user through such peripherals as the 
console, the printer, the disks, and so on. There are several electrical lines 
which are used to connect the CPU to the memory and to the peapheres 
These lines are collectively known as the buss, or bus. 

The CPU contains a set of registers, which are internal memory locations 
used for data storage and manipulation. One of these is a special register 
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called the accumulator. It receives the results of certain CPU operations. 
The CPU will also have a status register to indicate the nature of a previous 
operation, e.g., whether the result is zero or negative or positive. It will also 
indicate whether a carry or a borrow occurred during the operation. 

Additional registers are used for auxiliary storage. They may contain 
general information such as a number that is about to be added to the 
accumulator. Alternately, a register may contain a number that refers to an 
address in the main memory. The value is called a memory pointer in this 
case. A special portion of main memory may be set aside for storing data. 
This area is called a stack. A special register called a stack pointer refers to 
this region. Another register, the program counter, tells the CPU where to 
find the next instruction in memoty. 

Computer operations are controlled by a computer program. Those 
programs which are used to solve engineering and physics problems are called 
application programs. On the other hand, computer programs which deal 
with the operation of the computer’s own peripherals are known as systems 
programs. 

The instruction set used by the CPU can be very large and difficult to 
use. Consequently, symbolic programming languages are commonly used 
instead. An application program may be written in a language such as BASIC, 
FORTRAN, or Pascal. This is called a source program. Then a separate pro- 
cessor program called a compiler or an interpreter is used to convert the 
user’s source program into an object program that corresponds to the in- 
structions needed by the computer. 

A microcomputer’s instruction set is relatively small compared to that 
of a larger computer. But even so, it is more convenient to write systems 
programs in a symbolic language called assembly language, rather than in the 
machine language of the computer. A processor program, called an assem- 
bler, is then utilized to translate the source program into the corresponding 
instructions of the computer. A major difference between assembly language 
and higher-level languages such as Pascal is that each line of an assembly 
language program represents one computer instruction. By contrast, one line 
of a Pascal source program might represent many computer instructions. 

A line of an assembly language program can contain up to four ele- 
ments: the label, the mnemonic, one or two operands, and a comment. 


Label Mnemonic Orerand Comment 
START: CALL FIRST ginitialize data 


The label, which is usually terminated by a colon, is used to transfer control 
from one portion of the source program to another. The mnemonic repre- 
sents the desired CPU instruction. The operand might reference a CPU 
register, a memory location, or simply a constant. Finally, a comment, pre- 
ceded by a semicolon, can be used to explain the instruction. The comment, 
of course, is ignored by the assembler. 

The remainder of this chapter is devoted to a general discussion of some 
of the features of the 8080 and Z-80 CPUs. The complete instruction sets 
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for these CPUs are listed in the appendix. Specific details of each instruction 
are given in Appendix H. If you are already familiar with these instruction 
sets, then you might want to go on to the next chapter. 


THE 8080 CPU 


The 8080 CPU is an integrated circuit that has 40 pins (legs). It requires 
three power supply voltages—12 V, 5 V, and —5 V, and a two-phase clock 
that runs at 2 Megahertz (MHz). There is an accumulator, a flag register, six 
general-purpose registers, a stack pointer, and a program counter. The 
accumulator is sometimes known as register A. The flag register is usually 
called the PSW (the letters being an acronym for program status word ). The 
general-purpose registers are designated by the letters B, C, D, EK, H, and L. 
Sometimes the registers are paired into 16-bit double registers known as BC, 
DE, and HL. The accumulator and flag register may also be paired. There are 
78 different instruction types that produce a total of 245 different op codes. 


Accumulator Pe me mae se ett a Bae me ee oe ! Flas Register 

(Register A) f § bits ! 8 bits ! (PSW) 
Pee vse me oe ee ste a ff se ane ste ne a ie wt ne ef 

Redister & ! § bits ! 8 bits ! Resister C 
Pane et ca ae ae me oe Bw ae es set eto ! 

Register I ! § bits ! 8 hits ! Restister E 
i Soe Site ll ‘eat: an: ba Seen en be i cos Gubs "Same lente: Sides stan esd a Gate Saud i 

Resdister H i 8 bits ! 8 bits ! Resister L 
 eeleaientenetententeebetonten  eadententeateatententarnten J 

Stack Fointer ! 1&6 bits ! 
i ict ‘seg “Seen a io soma "don' bei sae, Sb ied “ebb wd nea. bose Cl, abu aise “abe: pack Sood ! 

Program i 16 bits ! 

Counter Pies ie etn mentee a wtf ne ! 


Figure 1.1. The 8080 CPU registers. 


Some of the 8080 instructions explicitly refer to the accumulator or to 
one of the general-purpose registers (B, C, D, E, H, and L). 


Mnemonic oFrerand comment 
INR A increment accumulator 
DCR B jdecrement resister B 
MOV HD move contents of It to H 
MVI C4 Put value of 4 into C 


When there are two operands, data moves from the right operand (the 
source) into the left operand (the destination). There are additional 8080 
commands that implicitly refer to the accumulator. 


mnemonic oPperand comment 
RAR § rotate sccumulator right 
RAL § rotate sccumulator left 
IN 0 6 inrFut a bute to A from Fort O 
OUT i § outPut 2a byte from A to rort 1 
ANI 7 § losdical AND with A and 7 
ORI 3 § losical OR with A and 3 


Se ea rasta reenter A es Be on 
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For certain 8-bit operations, the accumulator is implicitly one of the 
source registers and will contain the result of the operation. 


mnemonic orerand comment 
ADD . Cc ' add C to A 
SUB Li § Subtract OD from A 
ANA H § logical AND of A with -H 
ORA B § logical OR of A and EB 


Other instructions refer to coupled pairs of 8-bit registers. These 
extended operations treat the BC, the DE, and the HL register pairs as 16-bit 
entities. Sometimes the stack pointer and program counter are included in 
these instructions. The X symbol in the mnemonic refers to these extended 
16-bit operations. 


mnemonic oPperand comment 
INX H § increment HL resister rair 
“nex SF § decrement stack Fointer 
LXI ItyO § load zero into DE rair 


Additional instructions deal specifically with the HL register pair. The 
following two instructions move two bytes of data between memory and 
the HL double register. 


mnenonic orerand comment 
LHL 3 § addr 3» 4 to kL and H 
SHLI 3 5 Le to addr 3y 4 


The LHLD instruction copies the value at memory location 3 into the L 
register and the value at location 4 into the H register. The SHLD operation 
_ reverses the process. 

The XCHG operation interchanges the 16-bit HL register pair with the 
16-bit DE register pair. | 
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The SPHL command copies the HL register into the stack pointer register. 
The PCHL instruction copies the HL register pair into the program counter 
register. . 
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There are several instructions that perform double-register addition. 
The number in one of the 16-bit registers is added to the number in HL. The 
sum appears in the HL register pair. 


NAD D jadd TE to HL 
DAn SF stack Pointer + HL 
THE MEMORY REGISTER 


There is another 8-bit register for the 8080 that is not shown in Figure 1,1 
It is located in main memory. The 16-bit address contained in HL defines 
the location of this memory register, ie., HL is a memory pointer. The 
instruction 


MOV MrE jmove E to memory 


will copy the contents of register E into the memory location pointed to by 
the HL register pair. The instruction 


INR M . Sincrement memory 


will increment this byte in memory. 


THE FLAG REGISTER 


Four bits of the PSW register can be used to control program flow. The bits 
or flags are used in conjunction with conditional jump, conditional call, and 
conditional return instructions. We say that a flag is set if it has a value of 1 
or is reset if it has a value of zero. 

The CPU sets the sign flag (S) if the result of a previous operation is 
positive; the flag is reset if the result is negative. The CPU sets a second flag, 
the zero flag (Z), if the result is zero; it is reset if not zero. A third flag, the 
carry flag (C), is set if there is a carry on addition or borrow on subtraction; 
it is reset otherwise. A fourth flag, the parity flag (P), indicates the parity of 
the result. Parity is even if there is an even number of ones (or zeros) and 
odd otherwise. 


Pm Pm Pm Pe Pe me Pe fm | 
! L | ! | J | ! 
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Figure 1.2. The PSW (flag) register. 


The use of the flag register can be demonstrated with a simple routine 
Suppose that a group of instructions is to be executed eight times. The fol- 
lowing code will do this. 
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MVI Bs8 seut 8 into B 
LOOF? o 8 8 

ICR B idecrement B 

ANZ LOOF jloor if mot zera 


The B register is initialized to the value of 8. The DCR B instruction near 
the end of the loop decrements the B register each time the loop is executed. 
This will reset the zero flag on each of the first seven passes through the 
loop since B has not reached zero. The following conditional jump instruc- 
tion, JNZ LOOP, causes the CPU to return to the line labeled LOOP in 
this case. 

On the eighth pass through the loop the original value of 8 in the B 
register will have been decremented to zero. Now the zero flag will be set 
and the conditional jump instruction will not cause a branch. The instruction 
immediately following the jump will be executed instead. 


FLAGS AND ARITHMETIC OPERATIONS 


The results of addition and subtraction operations can be characterized from 
the PSW flags. Three of the flags are of interest here:’the carry flag, the zero 
flag, and the sign flag. If the sum of two numbers exceeds 255 (1 less than 2 
to the eighth power), then the result is too large to fit into the 8-bit accumu- 
lator. The carry flag will be set to reflect this overflow. During subtraction, 
the carry flag is set when a larger number is subtracted from a smaller one. 
In this case, the flag becomes an indication that borrowing has taken place. 

Sometimes all eight bits of a register or memory location are used to 
represent a number. This is then an unsigned number. At other times it is 
convenient to utilize only the low-order seven bits (bits 0-6) for the mag- 
nitude of a number. The remaining high-order bit (bit 7) is then used to 
indicate the sign. 


madnitude sign masnitude 
Fe me en en st et ts ! iol eetentententontentententontentaieabel ! 
| 8 bits ! 1 7 bits | 
1’dtettdt eo pttttdb¢t 
Pete fe ded cde Pale fainter heorevet 
76543210 7654321 0 
“unsigned number signed number 


‘Numbers represented in this way are known as signed numbers. A 0 in bit 7 
means that the number is positive and a 1 means that the number is negative. 
An 8-bit signed number can range in magnitude from -128 to 127, whereas 
an unsigned 8-bit number can range from 0 to 255. 

The sign flag is set after certain operations if the value of bit 7 is 1 and 
it is reset if bit 7 is 0. If the sum of two numbers is exactly 256, the result in 
the 8-bit accumulator will be a zero. This occurs because 256 is 1 greater 
than the largest 8-bit number (255). The zero flag will be set in this case. 
In addition, the carry flag will be set because there is an overflow. The parity 
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flag will be set, since there is an even number of ones. (Zero is an even num- 
ber.) Finally, the sign flag will be reset because bit 7 is a zero. 


FLAGS AND LOGICAL OPERATIONS 


In the case of arithmetic operations such as addition and subtraction, there 
can be a carry or borrow from one bit to another. But the logical operations 
AND, OR, and XOR (exclusive OR) operate on each bit separately; there is 
never a carry from one bit to the next. These logical operations, therefore, 
always reset the carry flag. The zero and parity flags, however, will be set or 
reset according to the result of the particular operation. We will discuss 
logical operations more fully in Chapter 2. 

A value in the accumulator can be compared to a value in another 
register or to the byte immediately following the instruction byte in mem- 
ory. The CPU performs the comparison by subtracting the value of the 
operand from the value in the accumulator. In the case of a regular subtrac- 
tion, the difference is placed in the accumulator. For example, the arithmetic 
instruction . 


SUB C 


subtracts the value in register C from the accumulator and places the differ- 
ence into the accumulator. The logical comparison operation 


CMF c 


also subtracts the value in register C from the value in the accumulator. 
However, unlike the regular subtraction operation, the difference in this case 
is not actually saved. The flags, of course, will reflect the result of the opera- 
tion. If the value in C is equal to the value in the accumulator the difference | 
between them will be zero. In this case the zero flag is set indicating the 
equality. The carry flag will be reset since there was no borrow during the 
subtraction. 

If the two values are not equal, then A is either larger or smaller. If A 
is larger, the comparison operation will reset the carry flag (and, of course, 
the zero flag). If A is smaller, then the carry flag will be set, because a larger 
number has been subtracted from a smaller one. Thus, if the carry flag has 
been set after a comparison, then the value originally in the accumulator 
must have been smaller than the value with which it was compared. 

The following instructions can be used to determine if the value in 
register C is less than, greater than, or equal to the value in the accumulator. 


¢ + + 


CMF Cc ' subtract A from C 

AZ ZERO i if A eauals C 

JIC LESS ’ if A less than C 
3 


if A sreater than C 
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The comparison instruction is executed first. This operation subtracts the 
‘value of C from the value in the accumulator. If the two numbers are equal, 
then their difference is zero. In this case, the zero flag is set and the JZ 
instruction causes a branch to the label ZERO. Otherwise, the next instruc- 
tion is executed. Another possibility is that the value in C is greater than the 
value in the accumulator. The subtraction in this case requires a borrow so 
. the carry (borrow) flag is set. The JC instruction then causes a branch to the 
label LESS. The last possibility is that the value in the accumulator is larger 
than that in register C. For this case, both the zero and the carry flags are 
reset, and the program continues. 


INCREMENT, DECREMENT, AND ROTATE INSTRUCTIONS 


The 8-bit increment and decrement instructions present an interesting case. 
Mathematically, the increment operation simply adds 1 to the current value 
in a register. Likewise, the decrement operation subtracts 1 from the present 
value. Thus, the two instructions 


INR A and 
All i 


both increase the value in the accumulator by 1 and the operations 


TCR A and 
SUI 1 


both decrease the value in the accumulator by 1. The zero, parity, and sign 
flags correctly reflect the result in all cases. - 

The carry flag, however, responds differently for the two cases. The 
flag correctly reflects the result of the operation in the case of addition, but 
_ it is unaffected in the case of an increment or decrement operation. Thus, if 
you need to increment or decrement a value without disturbing the carry 
flag, then you should use the INR or DCR instructions. On the other hand, 
if you need to know whether a carry or borrow occurred during an incre- 
ment or decrement, then use an add or subtract operation. 

The instructions following the label GETCH in Listing 6.1 (in Chapter 
6) are used to set ASCII characters from the console input buffer. As each 
character is obtained, the count of the remaining characters is decremented. 
When the count has been decremented past 0, then the routine is finished. 
Subtracting 1 from O requires a borrow so the carry flag should be set. But 
since the regular decrement operation doesn’t alter the carry flag, the sub- 
tract instruction must be used instead. 
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ROTATION OF BITS IN THE ACCUMULATOR 


There are four 8080 instructions that rotate the bits in the accumulator. The 
operations move each bit by one position. Two instructions rotate the bits 
to the right and two rotate them to the left. The right circular rotation 


RRC 


moves each bit one position to the right. The rightmost (low-order) bit is 
moved to the high-order bit and into the carry flag. 


*e, 
* 


i Pm mmf me Pe fm Pm Pe Pe Pee I ! Ped 
! f ! { ! f ! ! ! 


ms ~, *, %, , = a ‘ees ad Se eae eves ont My 
Bone ome i — > om ~e ms “p on :; Po oo * ! 


Pee me me om me Pm Pe Pee Pe Pee | ee | 
! ! j ! f ! i ! 


accumulator carry 
The left circular rotation 
RLC 


moves the bits the other way. 


Pee ce oe Searect tere paca ae oe ea SS soem te tte ote sre esse stn ene ne sn eet en “Spc ok se ! 

! j 
Piscmaie § j eked Redes Rete Deters fotree Peters pereres beeeees | ; 
! A me ae oe so kt ee en Lo sine Sw i a eter i 
B case wee ene kha Reeteied Reotetel Retell tree er oe ere 
carry accumulator 


Each bit is moved one position to the left. The high-order bit goes to both 
the low-order bit and to the carry flag. 
The rotate accumulator right instruction 


RAR 


moves each bit one position to the right. But this time, the carry flag moves 
into the high-order bit and the low-order bit moves into the carry flag. 


Bs ae se me ee ee a at ne ett ea cnet tt ttt nt tsetse cet sn sn to ane eae oer save cate wees weve vane wean ri” vere ff 

. “ 

Hy 

I es es rr (eee Dees Dene Dees Seana | [momen ff 
: : : : : : : : H : : : 

*, ”, s m, %, %, ty, ~% ae 

wine te { “ = oe anon ey wet “5s sane “te awe See seen Wee snes anes sete cone ones MY - 

Lora . a ‘ “ o - “ < “ we : 
Pomme Pm mm Pe Pe Pe Pee Pee Pet re | 
: ‘ : : H : : : : : 


accumulator carry 


The instruction 


RAL 
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moves each bit one position to the left. The carry flag moves into the low- 
order bit and the high-order bit moves into the carry flag. 


%, ,, te, te, 
[mse "toe ere meee ene nen some tee ten nate sees atom sees igo ree ete ope mete ete cotm tied seen ott ones bite tit oett "'ts seen ana eeey een som tet sett come Fete nett oiay een some an oate anon ott TEp ome sims anny nee ones sone 
a os nd . a * 
! ! 
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carry accumulator 


FLAGS AND DOUBLE-REGISTER OPERATIONS 


Double-register, or extended, operations involving HL, DE, and BC affect the 
flags very differently from the single-register operations. We saw that single- 
register increment and decrement operations did not alter the carry flag. The 
extended increment and decrement commands never alter any of the flags. 
This means that if a program is to loop until a double register has been 
decremented to zero, the following set of instructions will not work. 


LOOF: o 6 6 
nex H $1é-bit decrement 
ANZ LOOF sif mot zero 


The proper procedure is to compare the two 8-bit halves with each other. 
This can be done by moving one of the registers to the accumulator. 


MOV Ask 


Then the accumulator is compared to the other half by performing a logical 
OR. The result of this operation will set the zero flag only if both halves are 
zero. The complete operation looks like this. 


LOOP: ee 6 


pcx H §idé-bit decrement 
HOY Ael jmove L to A 

ORA H s0R with H 

JNZ LOOF sif not zero 


The double-register add instruction correctly sets the carry flag if there 
is an overflow from the 16 bits, but zero, parity, and sign flags are not 
altered. 


THE Z-80 CPU 
The Z-80 CPU is a 4.0-pin IC just like the 8080. All of the 8080 instructions 


are common to the Z-80, thus we say the Z-80 is upward compatible from 
the 8080. In general, any program that runs on an 8080 will also run on a 
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Z-80. The one exception is that the 8080 parity flag is affected by arithmetic 
operations, while the Z-80 parity flag is not. Thus, one can use an 8080 
assembler to generate 8080 code on a Z-80. 

The Z-80 requires only a single 5-volt power supply and a single-phase 
clock that can run as fast as 6 MHz. There are 158 instruction types that 
give a very large number of total commands with all variations. These are - 
given briefly in Appendixes E and F and in more detail in Appendix H. The 
Z-80 contains all of the 8080 general-purpose registers, plus an alternate set 
for easy interrupt processing. The alternate set is indicated with a prime 
symbol: A’, B’, and so on. Only one of the two general sets of registers can 
be used at any time, therefore, data cannot be transferred directly from one 
set to the other. There are also two 16-bit index registers called IX and IY, 
an 8-bit interrupt register (I), and an 8-bit refresh register (R). 

Primary registers Alternate resisters 
8 bits FSW A’ ! 8 hits 8 bits ! PSW’ 
8 bits !C 8 ! 8 bits ! 8 bits ! C! 
B bits !E D’ ! 8 bits ! 8 bits ! E’ 


8 bits ! L’ 


i 
i 
j 
i 
H 
i 
i 
i 
H 
i 
1 
i 
i 
i 
j 
H 
i 
i 
i 
i 
j 
i 
i 
i 
i 
} 
1 
i 
} 
I 
i 
i 
} 


Index discreet rie eee Sein oa ! 
Redister X t 16 bits ! 


Index ! 14 bits ! 
Resister Y Le ee ee ee ee ! 


Interrupt Do a oo i a ae on ! 
Redister [I 1 @ bits ! 


Refresh ' 8 bits ! 
Redister R Doe ma a ee ! 


Figure 1.3. The Z-80 CPU registers. 


An operand for an assembly-language instruction may consist of a value 
that is used directly, or it may refer to a location that contains the value. For 
example, the command 


Lo APG 


instructs the CPU to place the value of 6 into register A. Similarly, the 
instruction 


Lit Ar D 
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will move the contents of register D into register A. Alternately, the operand 
may be a pointer to another location. Thus the command 


Lo Ay (46) 


will move the byte located at address 6 into the accumulator. Similarly, the 
instruction 


LD Av (HL) 


tells the CPU to move the byte pointed to by the HL register into the 
accumulator. The Z-80 mnemonics clearly differentiate a pointer by means 
of the parentheses, whereas the corresponding 8080 mnemonics do not make 
such a clear distinction. 


Z-80 RELATIVE JUMPS 


Computer instructions are generally executed in order, one after the other. 
But it is sometimes necessary to branch out of the normal sequence of state- 
ments. Branching statements can be classified as either conditional or uncon- 
ditional. An unconditional or absolute branch always causes the computer 
to execute instructions at a new location, out of the normal flow. Condi- 
tional branching, on the other hand, is based upon the condition of one of 
the flags. 

Programs utilizing the Z-80 instruction set can be significantly shorter 
than those written with 8080 operation codes, especially if the relative jump 
instructions are used. Relative jumps are performed by branching forward or 
backward relative to the present position. Absolute jumps, on the other 
hand, are made to a specific memory location. Furthermore, there are both 
unconditional and conditional branch instructions. The absolute, uncondi- 
tional jump op code and the conditional jump codes based on the state of 
the zero and parity flags are all three-byte instructions. 


JP ADDR s unconditional Jume 

JP Zr» ANDR2 § Jume if zero flas set 

JP NZ»sADDRS ¢ Jump if zero fleas reset 
JP CrADDR4 § Jumre if carry flad set 
dF NCesABDRS ¢ Jume if carry fled reset 


The above instructions are available on both the 8080 and the Z-80 CPUs. 
In addition, the Z-80 has a relative, unconditional jump and five relative, 
conditional jumps. 


JR ADDR § unconditional ume 
JR ZrADIKG § zero 
JR. NZ,ADDR? § mot zera 
JR CeoADURS ¢ carry 
JR NC»sADDRE §¢ mot carry 
g 


DINZ ANBRLO decrs Jjumr mot zero 
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The relative jumps are only two bytes long as opposed to three bytes 
for the regular jumps, but the relative jump is limited to a displacement of 
less than 126 bytes forward or 128 bytes backward from the address of the 
current instruction. These numbers derive from the magnitude of the signed 
8-bit displacement. Bit 7 is used for the sign of the number. A 0 in bit posi- — 
tion 7 means a forward or positive displacement, a 1 in this bit position 
means a backward or negative displacement. The remaining seven bits are 
used for the magnitude of the jump. 

Absolute jumps are specified with a 16-bit address that gives the new 
location. Relative jumps on the other hand are position-independent. The 
resulting code can be placed anywhere in memory. The last operation above, 
DJNZ, is a combination of two instructions. The B register is decremented. 
If the result is not zero, then there is a relative jump to the given argument 
ADDR10. This two-byte instruction requires four bytes on an 8080 CPU. 


Z-80 DOUBLE-REGISTER OPERATIONS 


While some of the Z-80 instructions appear to be shorter than their 8080 
counterparts, they may not actually reduce the program size. Suppose, for 
example, that we want to move a block of data from one memory location 
to another. There is a single Z-80 instruction for accomplishing this task. 
The problem is that no verification is performed during the move. Thus, if 
there were no memory at the new location, or if the memory were defective, 
this fact would not immediately be discovered. If you want to check each 
location as the data are moved, then the Z-80 block-move instruction cones 
be used. 

A better way to move data is to define the beginning of the Seu 
memory block with HL and the end with DE. The BC register defines the 
beginning of the new block. We can work our way through the original block 
by incrementing HL and BC at each step along the way. 

The end of the block can be detected when HL exceeds DE. We sub- 
tract the two 16-bit registers and observe the carry flag. The HL register pair 
will initially be less than the DE pair. Therefore, if we subtract DE from HL, 
we will set the carry (borrow) flag. 

Eventually, the number in the HL register will equal the value in the 
DE pair. This time, the subtraction will not set the carry flag and the task — 
will be completed. Since the 8080 doesn’t have a 16-bit subtract instruc- 
tion, the routine might look like this. 


LOOP? 2 8 6 § 8080 version 
MOVE Agh § GET L 
SUB E § SUBTRACT E 
MOV AvH § GET H 
SBB Q § SUBTRACT [Ti AND BORROW . 
JC LOOP ? IF NOT TONE 
RET ¢ IONE 
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As long as HL is less than DE, the subtraction will set the carry flag and the 
loop will be repeated. But as soon as HL equals DE, the carry flag will be 
reset and the subroutine is finished. 

The Z-80 has a 16-bit subtract instruction that can simplify the opera- 
tion. But since the result of the subtraction is placed in the HL register pair 
rather than in the accumulator, the data originally present in HL will have to 
be saved somewhere else, say, on the stack. The Z-80 code is: 


LOOP! . .. § 7-80 version 

. OR A § RESET CARRY 

PUSH HL § SAVE HL ON STACK 

SEC HL » DE ¢ SUBTRACT DE FROM HL 

POP Hi § RESTORE ORIGINAL HL FAIR 
JR CreLOOrF ¢ IF NOT BONE 

RET 


The necessary Z-80 instructions require just as many bytes as the corre- 
sponding 8080 code. And if the carry flag on the Z-80 has not been reset by 
a previous instruction, it will have to be reset at the beginning with a logical 
OR instruction. This latter problem occurs because the Z-80 16-bit subtrac- 
tion includes the carry flag in its calculations. 


Z-80 INPUT AND OUTPUT (I/O) INSTRUCTIONS 


A useful pair of Z-80 instructions deals with input and output, i.e., the 
transfer of data between the CPU and peripherals such as the console, the 
printer, and the disk. The 8080 can only input and output data from the 
accumulator, and the address of the peripheral device must immediately 
follow the IN or OUT instruction in memory. 


OUT 10 
IN ii 


This usually means that for read-only memory (ROM), there must be sepa- 
rate input and output routines for each peripheral. 

In contrast, the Z-80 can input or output a byte from any of the 
general-purpose registers when the peripheral address is in the C register. 
In this case, it may be possible to use a single set of I/O routines for all 
peripherals. This approach is discussed more fully in Chapter 4. 


SHIFTING BITS 


The Z-80 CPU extends the four 8080 rotate instructions to the general- 
purpose registers B, C, D, E, H, and L. The memory byte referenced by HL, 
IX, and IY is also included. 

7 The Z-80 instruction set includes three shift operations. Shifts are 
_ similar to rotations since each bit moves one position and the bit that is 
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shifted out of the register is moved into the carry flag. The difference is in 
the bit that is shifted into the register. 
The arithmetic shift left . 


SLA 


shifts all bits to the left. A zero bit moves into the low-order bit. 


peel Pi eee ae Piet Peto Paes fee ee | Gee 
: : : : . : . ‘ : ‘ : 
t i ee a ee ne see ar a sa cA ie tm ed < od am we ! Pare 0 
1. — | telat tated Retetee Rett Rte cots tered etree | 


Carry accumulator 


The operation doubles the original 8-bit value. This operation can be per- 
formed on the accumulator of an 8080 by using an 


Atm A 


instruction. 
A logical shift right 


SRL 


is the inverse of the arithmetic shift left operation. Each bit shifts one posi- 
tion to the right. A zero bit is shifted into the high-order position. 


(Soe See Sees Be es Pee eat ee 
I f ! f I i ! j ! i ! 
Ov Ses j me eR eR ee ee ee eee { 
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accumulator carry 


This operation halves the original 8-bit value. The carry flag is set if the 
original value was odd, that is, if there is a remainder from the division. 
The arithmetic shift right 


SRA 


shifts each bit one position to the ment but the original high-order bit is 
unchanged. 


Permit hee Tee Pe Teen he Vee et Lae 
fame Ol a a a a el ae oa ! 
! oaleaioel Seeateateadl Reatenleal Reateatiad Renteeteall Coateateall Retell Rented | Lae] 
! ! accumulator carry 


i Apter ats Ca Se ! 


Ms 


This operation can be used to divide a signed number in half. The high-order 
bit, the sign bit, is unchanged. As with the logical shift right, the carry flag is . 
set if the original number was odd. 


CHAPTER TWO 


Number Bases 
and Logical Operations 


In this chapter we will consider how numbers are stored in a computer. We 
will also look at some of the operations that can be performed on these 
numbers. But first we will review the representation of numbers in general. . 
When we write a number such as 245, we usually mean the quantity 5 plus 
AO plus 200. 


2 4 5 (decimal) 


ae 5X 1= 5 
—————— 4X 10= 40 (4 x the base) 
— 2X 100 = 200 (2 X the base squared) 
245 (decimal) 


This is the ordinary decimal or base-10 representation of a number. The 
rightmost digit gives the number of units. The digit immediately to the left 
is the number of tens (the base). The next digit to the left is the number of 
100s (the base squared). 

In assembly language programs it is sometimes convenient to represent 
numbers with a base of 2, 8, or 16. In the octal, or base-8, system, for exam- 
ple, the number 245 is equivalent to the decimal number 165 (5 plus 32 
plus 128). 


24 5 (octal) 


| oer 5X l= 5 
4X 8= 82 (4 X the base) 
2 X 64 =128 (2 X the base squared) 


165 (decimal) 


16 
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This example demonstrates how to convert numbers from other bases into 
the decimal representation by adding up the decimal equivalent of each digit. 
In the binary, or base-2, system, only the digits 0 and 1 are used. The 
individual digits are called bits, an acronym for binary digits. The rightmost 
bit represents the units. The bit immediately to the left is the number of 2s _ 
(the base). The next bit to the left is the number of 4s (the base squared). 
We continue in this way through all of the bits. For example, the binary 
number , 


10100101 


is equivalent to the decimal number 165. The conversion is obtained in the 
following way. 


t 20-2: 20: 20 a. O° 9 (binary) 
1X 1= 1 
OX 2= 0 
1X 4= 4 
OX 8= 0 
0X 16= 0 
—— 1X 32= 32 


SS ee eee Ie 128 
165 (decimal) 


We have seen that the decimal system utilizes ten different digits (0-9). 
The octal system, however, utilizes only eight digits (0-7), and the binary 
system uses only two (0-1). The hexadecimal, or base-16, system is also 
commonly used in computer programs. With this method, we need 16 differ: 
ent digits. The problem is that if we use all of the digits (0-9) from the 
decimal system, we will still be six digits short. The solution is to use the 
letters A through F to represent the digits beyond 9. Thus, the hexadecimal 
number A5 is equivalent to the decimal number 165. We can convert a hexa- 
decimal number into decimal in the usual way if we remember that A stands 
for decimal 10, B for 11, and so on. 


A 5 (hexadecimal) 
| eres 5X 1= 5 
———- 10 X 16 = 160 (10 times the base) 
165 (decimal) 


The first 16 integers of the decimal, binary, octal, and hexadecimal systems 
are shown in Table 2.1. 
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Table 2.2. The first 16 integers represented 
in various number systems. 


decimal binary octal hex 
0 0000 000 00 
1 QOOL 001 O01 
2 0010 002 02 
3 0011 003 03 
4 0100 004 04 
5) 0101 005 05 
6 0110 006 06 
7 0111 007 07 
8 1000 010 08 
9 1001 O11 09 
10 1010 012 OA 
11 1011 013 OB 
12 1100 014 OC 
18 1101 015 OD 
14 1110 016 OE 
15 1111 017 OF 


Table 2.1 shows the common practice of displaying leading zeros on 
numbers expressed in bases other than 10. Thus we write 5 for a decimal 
number, but we may write 005 if it is an octal number or 05 if it is a hexa- 
decimal number. We may explicitly represent the base by a suffix. In books, 
for example, we typically utilize a subscript in smaller size type. Thus we 
will write: 


1010, (binary ) 
17. (octal) 
1710 (decimal) 
1716 (hexadecimal) 


Alternately, we use suffixes of B, Q, D, and H to designate, respectively, 
binary, octal, decimal, or hexadecimal mode in computer programs where 
subscripts are not available. 


1010B (binary) 

17Q (octal) 

17D (decimal) 
17H (hexadecimal) 


(The letter Q is used instead of an O for an octal number to avoid confusion 
with zero.) 
Binary numbers such as 


011001101111 
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can be difficult to read, so it is common practice to represent them in octal 
or hexadecimal form. Conversion to octal is easy if the bits are grouped by 
threes. : 


O11 001 101 111 (binary) 
3 1 5 7 (octal) 


Grouping by fours facilitates the conversion to hexadecimal. 


0110 0110 1111 (binary) 
6 6 F (hexadecimal) 


NUMBER REPRESENTATION IN BINARY, BCD, AND ASCII 


All information is ultimately stored in computers as a series of binary digits. 
There are, however, several different coding schemes for representing the 
original data. The simplest method is to use straight binary coding, as shown 
in Table 2.1. Notice that we might choose to represent a binary value in 
decimal, octal, or hexadecimal notation. The number itself is unchanged by 
this. The decimal number 12, for example, is stored as the binary number 
1100. . 

A different method of representing data is called binary coded decimal 
(BCD). Actually, there are two types of BCD: unpacked and packed. With 
unpacked BCD, each byte contains a single decimal digit from 0 to 9. Packed 
BCD can have one or two decimal digits in each byte. Thus, a packed BCD 
number can range from 0 to 99. By comparison, an 8-bit binary number can | 
range from 0 to 255. Table 2.2 shows the first 16 integers in BCD. The first 
column gives the decimal equivalent, the second column the corresponding 
bit pattern. 


Table 2.2. The first 16 integers represented in 
decimal and binary-coded decimal (BCD). 


decimal BCD 
0 0000 0000 
1 0000 0001 
2 0000 0010 
3 0000 0011 
4 0000 0100 
5 0000 0101 
6 0000 0110 
7 0000 0111 
8 0000 1000 
9 0000 1001 
10 0001 0000 
11 0001 0001 
12 0001 0010 
13 0001 0011 
14 0001 0100 
15 0001 0101 
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Notice that the binary representation for the decimal numbers 0 through 9 
- is the same for both binary and for BCD. 

A third method for encoding data is called ASCII. This scheme is com- 
monly used with peripherals such as printers and video terminals. When the 
key labeled 2 of.an ASCII console is pressed, the bit pattern 


0011 0010 


is generated. Table 2.3 gives the bit patterns for the ASCII digits 0-9 in 
binary and hexadecimal notation. 


Table 2.3. The bit pattern for the ASCII digits 0-9. 


digit binary hexadecimal 
0 0011 0000 30 
1 0011 0001 31 
2 0011 0010 32 
3 0011 0011 33 
4 0011 0100 34 
5 0011 0101 35 
6 0011 0110 36 
7 0011 0111 37 
8 0011 1000 38 
9 


0011 1001 39 


LOGICAL OPERATIONS 


The fundamental operations of a computer involve electrical signals that can 
have only one of two values. The two voltage levels might be zero and 5 
volts, for example, or they might be something else. The actual value is 
unimportant at this point. Instead, we refer to the two allowable states as 
TRUE and FALSE. The TRUE state is also called a logical 1, or high state, 
and the FALSE state is also known as a logical 0, or low state. 


TRUE =1 (high) 
FALSE =0 (low) 


Computers store numbers in binary form as a series of 1s and Os. These two 
possible values correspond to the two possible voltage levels of the electronic 
circuitry. We can therefore utilize the expressions TRUE and FALSE to 
describe the state of each bit. 

The collection of transistors, resistors, and so forth that makes up the 
physical computer is called the hardware. The computer program used to 
direct the activities of the computer is termed the software. In this sense, the 
hardware and software are distinctly different. But sometimes we use these 
terms a little differently. | 
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Consider, for example, one of the major differences between minicom- 
puters and microcomputers. Minicomputers contain electronic circuitry for | 
the multiplication of two numbers. Since microcomputers do not contain 
such circuitry, multiplication is performed instead by executing a special 
computer program. We say that minicomputers perform multiplication by | 
hardware, but that microcomputers must do multiplication by software. 

Hardware operations are performed by electronic devices called gates. 
The internal structure of the gate is unimportant if we are only interested in | 
the logic of its operation. There are input signal lines that are sampled by the 
gate, and there is an output signal that is generated by the gate. When we 
consider the logical operations that are performed by a computer, we can 
imagine that they are accomplished either by hardware or by software. The 
answer is the same. 

A common logical operation is the complement or inversion of a binary 
digit. The complement of 0 is 1 and the complement of 1 is 0. The hardware 
complement is performed with an inverter or NOT gate. The electronic 
symbol for this gate, shown in Figure 2.1, is a triangle with one apex to the 
right (usually) or to the left (sometimes). A small circle or triangle at this 
apex completes the symbol. 


a 


Figure 2.1. The electronic symbol for the NOT or inverter gate. 


Letters of the alphabet are used to designate input or output signals. 
These binary signals can have one of two states, termed TRUE (1) or FALSE 
(0). The letter A with a bar over it (A) represents the complement of A and 
is called NOT A. A truth table is used to summarize the possible states. 


A A or A A 
0 1 FALSE TRUE 
1 0 TRUE FALSE 


THE TWO’S COMPLEMENT 


If each bit of an 8-bit byte is complemented, we produce a result that is 
termed the one’s complement of the byte. 


0000 1001 = 9 
1111 0110 = one’s complement of 9 


Both the 8080 and the Z-80 CPUs provide an operation code for comple- 
menting the accumulator. A slightly different operation is the two’s com- 
plement. It is obtained by incrementing (adding 1 to) the one’s complement 
of a number. For example: 


eee NL TLE CULES CNA eee ORNATE: semermerstramnnvneanrnmt 
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0000 1001 = 9 


1111 0110 = one’s complement of 9 
+ 0000 0001 add one 


1111 0111 = two’s complement of 9 


It is interesting to note that the sum of a number and its two’s comple- 
ment is zero. 


1010 1010 = 170 


0101 0101 = one’s complement of 170 
+ 0000 0001 add one 


0101 0110 = two’s complement of 170 


0101 0110 = two’s complement of 170 
+1010 1010 = 170 


* 0000 0000 sum 
Adding the two’s complement of a number produces the same result as 
- subtracting the number itself. For example, we can subtract 170 from 223 


by adding the two’s complement of 170. The result is the same. 


1101 1111 = 223 


- 1010 1010 170 
0011 0101 = 83 
or 
11011111 = 223 
+ 0101 0110 = 2’s complement of 170 
0011 0101 = 53 


The 8080 CPU can perform both addition and subtraction with 8-bit 
numbers and it can add 16-bit numbers, but there is no 16-bit subtraction 
operation. We can effectively perform a 16-bit subtraction, however, by 
adding the two’s complement. Suppose that the HL register pair contains 
the decimal value 10,005 and we want to subtract 10,000 from it. The dif- 
ference between 10,005 and 10,000 can be obtained by adding the two’s 
complement. Consider the bit pattern for the number 10,000. 


0010 0111 0001 0000 = 10,000 
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We first form the one’s complement, then increment the result to form the 
two’s complement. 


1101 1000 1110 1111 = one’s complement of 10,000 
+ 0000 0000 0000 0001 add one 


1101 1000 1111 0000 = two’s complement of 10,000 


Finally, we add this two’s complement to the value in HL. 


0010 0111 0001 0101 10,005 in HL 
+ 1101 1000 1111 0000 = two’s complement of 10,000 


0000 0000 0000 0101 ~~ difference (sum) is 5 


When an assembler encounters a negative argument, it will automati- 
cally calculate the corresponding two’s complement. Thus the 8080 ex- 
pression 


LXI = Byv-10000 
will place the bit pattern 
1101 1000 1111 0000 
in the DE register pair. The instruction 


DAD ti 


will then effectively perform a 16-bit subtraction on the number in HL. 


LOGICAL OR AND LOGICAL AND 


In the previous section, we considered the logical operation of NOT. Two 
other important logical operations are OR and AND. Both of these opera- 
tions reflect the usual English meaning. The logical OR of two bits results in 
a value of TRUE (1) if either or both the original values are TRUE. The 
result is FALSE otherwise. The logical AND of two values gives an answer 
of TRUE (1) if and only if both of the original values are TRUE. If either or 
both the original values are FALSE, then the answer is FALSE. 

Equations of logical operations can be written using the appropriate 
symbols. Two OR operators are in common use: a plus symbol and a V- 
shaped symbol. The AND operator is either a dot or an inverted V. The 
schematic representations of the OR and AND gates are shown with their 
corresponding mathematical representations in Figure 2.2. 
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ST) xn Spe x-a 
B B 


Figure 2.2. The OR and the AND gates. 


The truth table is 
(OR) (AND) 
A B A+B A-B 
0 0 0 0 
0 1 1 0 
1 0 1 0 
i 1 1 1 


where zero means FALSE and 1 means TRUE. The origin of the + symbol 
for the OR operation and ° symbol for the AND operation can be seen from 
the truth table. Logical operations are performed separately on each bit, and 
there is never a carry. The logical OR (sum) of A and B gives zero if both 
bits are zero, but 1 otherwise. (Binary digits can’t be larger than 1.) The 
~ logical AND (product) of A and B gives zero if either or both bits are zero 
and unity otherwise. 


SETTING A BIT WITH LOGICAL OR 


Sometimes, we need to set one or more bits of the accumulator. We can use 
the logical OR operation for this purpose. From the truth table in the pre- 
vious section, we can see that a logical OR of 1 with either a 0 or a1 will 
give a result of 1. 


A B A+B 
1 0 1 
1 1 1 


Thus, a logical OR of any bit with a 1 will set that bit. On the other hand, a - 
logical OR of 0 and another bit gives the result of that other bit. 


A B A+B 
0 0 0 
0 1 1 


In this case, the second bit is not changed. 
Suppose that the accumulator contains a binary 5 and we want to con- 
vert it to an ASCII 5. 


0000 0101 
0011 0101 


binary 5 
ASCII 5 


ll 
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If we compare the two bit patterns, we can see that they are the same except: 
for bits 4 and 5. These bits can be set by executing a logical OR with an 
ASCII zero. 


0000 0101 = binary 5 
OR 0011 0000 = ASCII zero 
0011 0101 = ASCII5 


The OR operation has set the bit corresponding to the location of the 1, but 
it has left the other bits unchanged. 
A logical OR of a register with itself does not change the value. 


O101 1010 = 5A hex 
OR 0101 1010 5A hex 


II 


0101 1010 = 5A hex 
But this operation can be used to set the flags. In this example, the ZeYO, 
carry, and sign flags are reset and the parity flag is set. 
RESETTING A BIT WITH LOGICAL AND 
A logical AND operation can be used to reset any particular bit of the 


accumulator; the truth table shows how. A logical AND of 0 and either a 0 
or a1 will always give a result of 0. 


A B A°B 
0 0 0 
0 1 0 


Thus, the bit is reset. On the other hand, a logical AND of 1 and another bit 
will give the value of the other bit. 


A B A°B 
1 0 0 
1 1 1 


Thus the AND instruction can be used to reset or “turn off” particular bits. . 
This step is sometimes called a masking AND operation. . 

When the CPU reads an ASCII character from the console, it gets an 
8-bit byte. But since the ASCII code contains only 7 bits, the high-order bit 
is not needed. The console-input routine typically resets this bit by per- — 
forming a masking AND operation. Suppose that the console transmitted an 
ASCII 5 with the high-order bit set. The bit pattern looks like this. 


1011 0101 
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The high-order bit can be reset with an AND operation. 


1011 0101 (original byte) 
AND 0111 1111 (mask) 


0011 0101 (ASCII 5) 


LOGICAL EXCLUSIVE OR 


The ordinary OR operation is sometimes called an inclusive-or operation to 
distinguish it from the exclusive OR (XOR) operation. For this latter opera- 
tion, the result is TRUE only if the corresponding bits of both values are 
different. Either A or B must be TRUE, but not both. The XOR operation 
is represented by a plus symbol surrounded by a circle. The complement of 
the XOR is the exclusive NOR or XNOR. It can be used as a comparator. 
The hardware implementation is sometimes used in circuitry to enable 
memory boards. The result is TRUE if and only if both corresponding bits 
are identical.:The result is FALSE otherwise. The truth table is: 


He O © PD 
HYOrOtbt 


The exclusive OR of a bit with itself will always be FALSE. Therefore the 
XOR of the accumulator with itself will set it to zero. 


0111 1100 = 7C hex 
XOR 0111 1100 = 7C hex 
0000 0000 = zero 


~The corresponding electronic symbols for the hardware implementation of 
the XOR and XNOR are shown in Figure 2.3. 


Doe SDD 
X=A@®OB X=A@®OB 
B B 


Figure 2.3. The exclusive or (XOR) and comparator (XNOR) gates. 


LOGICAL NAND AND NOR GATES 


By combining an inverter gate in series with the AND and OR gates, a new 
set of gates is formed. The NOT AND gate is called a NAND gate; it is shown 
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in Figure 2.4. The NOT OR gate is known as a NOR gate; it is shown in 
Figure 2.5. 


A Sarees A purer 
X=A°:B X=A 
B B 


Figure 2.4. The NAND gate can be produced from an AND gate and a NOT gate. 


A ee A 
X=A¥B X=AF 
B B 


Figure 2.5. The NOR gate can be formed from the OR gate and the NOT gate. 


From the truth table, it can be seen that the outputs of the NOR and NAND 
gates are the inverse of the corresponding OR and AND gates. 


A B A+B AB 
0 0 1 1 
0 1 0 1 
1 0 0 1 
1 1 0 0 


If both inputs of the NOR gate are connected together, then the gate 
behaves like a NOT gate. The same is true for the NAND gate. This can be 
seen by comparing the first and last rows of the truth tables. In this way, 
two NOR gates can be combined serially to produce an OR gate. The result 
is a NOT NOT OR gate that is equivalent to an OR gate. This is shown in 
Figure 2.6. In a similar way, two NAND gates can be used to make an AND 
gate as shown in Figure 2.7. Since OR and AND gates cannot be similarly 
combined to produce the NOR and NAND gates, we will find that NAND 
and NOR gates are more common. 


x ATB 


Figure 2.7. Two NAND gates are combined to produce an AND gate. 
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MAKING OTHER GATES 


NOR and NAND gates are very versatile. NOR gates or NAND gates can be 
combined to produce all of the other gates. This can be seen from the fol- 
lowing truth table. 


A B A B AtB A*B A+B A:B A+B” AB 
0 0 1 1 0 0 1 1 1 1 
0 1 1 =O 1 0 1 0 0 1 
1 0 oO 1 i 0 1 0 0 1 
1 1 0 O 1 1 0 0 0 0 


Notice that column 7 of the truth table has the same values as the last 
column. Similarly, columns 8 and 9 are identical. These relations follow 
De Morgan’s theorem, which can be expressed mathematically as: 


A+B=A°:B and 
A*B=A+B 


The corresponding digital gates are shown in Figures 2.8 and 2.9. 


Figure 2.9. A NOR gate is obtained from four NAND gates. 


The use of a small circle to represent inverted output brings up another 
approach to the understanding of digital logic gates. In the more commonly 
used system, the small circles are used only on the output side of the gate. 

Another approach, however, is to always connect active-high outputs 
to active-high inputs, and active-low outputs to active-low inputs. For this 
latter system, NAND gates will sometimes appear as OR gates with inverted 
inputs, and NOR gates will sometimes appear as AND gates with inverted 
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inputs. According to De Morgan’s theorem, the NAND gate is equivalent to 
the OR gate with inverted input signals. This is demonstrated in Figure 2-10. 
The circuit shown is logically the same as the one shown in Figure 2.9. 
Notice that the active-low outputs of the first NAND gates are connected to 
the active-low inputs of the next OR gate. That is, there are small circles on 
the outputs of the first gates and on the inputs of the second gate. 


Figure 2.10. A NOR gate is produced from four NAND gates. The middle NAND 
gate is shown in its alternate representation. 


CHAPTER THREE 


The Stack | 


When main memory is used to store a collection of data, each member of 
the data set is individually accessible. This type of storage is termed random 
access memory (RAM). Magnetic tape storage, by contrast, is serial or 
sequential access memory. In this latter case, only one item of the set is 
available at any one time. There are two ways of storing and retrieving the 
items in a serial memory buffer: one is by means of a first-in, first-out 
(FIFO) buffer, and the other is by means of a last-in, first-out (LIFO) buf- 
fer. We can visualize the serial buffer as a long string of information. With 
the FIFO buffer, items are added at one end and removed from the other. 
This buffer is analogous to an escalator: the people who ride the escalator 
are like the data—those who get on first, get off first. 


Out 


Figure 3.1. The first-in, first-out (FIFO) buffer. 
With the LIFO buffer, on the other hand, the data are added and 


removed at the same place. This arrangement is analogous to a very long, 
narrow elevator. Those who get on first, have to wait until everyone else is 
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off before they can get off. It can be seen that magnetic tape is a FIFO 
medium. 


Figure 3.2. The last-in, first-out (LIFO) buffer. 


Sometimes, a special area of main memory is designated as a LIFO 
buffer even though each member of the buffer is individually accessible. 
This region is known as a stack. As an example, Hewlett-Packard calculators 
utilize a very short LIFO stack, consisting of registers known by the letters 
Y, Z, and T. An item in any of the registers is individually accessible, yet the 
stack as a whole can be manipulated. As data is entered from the keyboard, 
it is placed into the X register. This information can then be transferred to’ 
the stack (register Y in this case) by pressing the ENTER key. We say that 
the contents of the X register are pushed onto the stack. Items can be 
retrieved from the stack and placed in the X register with the roll-down (R) 
key. We say that data are popped from the stack into the X register by this 
means. Another stack operation is performed by the EXCHANGE key which 
is used to swap the contents of the X and Y registers. 


STORING DATA ON THE STACK 


We have seen in the previous chapters that the 8080 and Z-80 microprocessors 
incorporate general-purpose registers for the storage of information. But 
these registers are limited in number. Consequently, a special area of main 
memory is designated for the additional storage of information. This area, 
called the stack, is implemented on the Z-80 and 8080 as a last-in, first-out 
serial buffer even though each item in the stack is individually accessible. 
One of the CPU registers, the stack pointer, references the current location 
in memory. This is the address of the most recently added item. The stack 
pointer is decremented as items are added and incremented as items are re- 
moved. The programmer may place the stack anywhere in memory by load- 
ing the stack pointer with the desired address. For example, the instruction 


LE SF » 4000H (Z-80) or 
LXI SF » 4000H (8080) 


initializes the stack to location 4000 hex. 
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Data can be placed on the stack with one of the PUSH operations. A 
command of 


(Z-80) (8080) 
PUSH ‘HL PUSH H 


will move a copy of HL to the stack. Since main memory is addressed eight 
bits at a time, the PUSH operation is actually performed in two stages. The 
stack pointer is decremented, then the H register (the high half) is copied to 
the stack. The stack pointer is decremented a second time and the L register 
(the low half) is copied to the stack. The stack pointer register now contains 
the address of the low byte. Figure 3.3 demonstrates the action of a PUSH HL 
command. The region of memory devoted to the stack is shown with higher 
memory upward. The arrow represents the stack pointer. 


Address 
SP foes ee = i Piensa oo ! a ar as ! 
ama > } I i § § | 4000 
f=ose= Y. “SP lasers ! Leace aes ! 
! fee=> |! high ! ! high |! SFFF 
[eee ssh ! Lena ! SP Leta ! 
! ! ! fo sm=> | low ! 3FFE 


Figure 3.3. The HL register is pushed onto the stack. 


The POP instruction reverses the PUSH process. For example, a POP DE 
command copies 16 bits from the stack into the DE register. Because the 
stack operates in a LIFQ manner, the most recently added byte is removed 
first. This is placed into register EK (the low half of the DE pair). The stack 
pointer is automatically incremented and the next byte is transferred from 
memory to register D (the high half). The stack pointer is then incremented 
a second time. Figure 3.4 demonstrates the operation. Notice that the data 
originally pushed onto the stack is still present. 


Address 
eee eueecaaeten ! 
! ! 4000 
| -———— ! 
! hish | SFFF 
SP  Roalealententeneniaal ! 
sm > ! low ! SFFE 


Figure 3.4. Two bytes are popped from the stack into DE. 
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It can be seen that the stack grows downward in memory as data are 
pushed into it, and it moves back up as data are popped off. For this reason, 
it is common practice to initialize the stack pointer to the top of usable — 
memory. Actually, the stack pointer can start at one address above the top 
of memory since the stack pointer is always decremented before use. 

If the general-purpose registers contain important information but they 
are needed for a calculation, it will be necessary to save the original data. 
This can be easily done by pushing the contents onto the stack. The registers 
are restored at the end of the calculation with the three corresponding POP 
commands. The operation goes like this. 


FUSH HL. §save HL. 

FUSH BE isave DE 

PUSH BC §save BC 

eo 8 86 jdo the calculation 
POF BC jrestore EC 

POP . DE srestore DE 

POF AL restore HL 


Notice that the order of the POP commands is reversed from that of the 
PUSH sequence. This is necessary because of the stack’s LIFO operation. 


STACK 

| mn pew ennn nan eet | 
t H j t H $ i H i] 
Sp Bere nso een eee sate vt snes ene } Pea sae sare eve ne st see ote ste i cm sare coe ere soe se see tes son ' 
mam | L i ! L ' ! L ! 
| =n anna ! f nea ! | ae a 
! a t } 4] ! 
GP | ~~---~---- ! [mam min ! 
saat | E | E 
Boe we sr sae eet ee amt se ene ! Bsa ore sae sot me ees ste ton see I 
i R ! 
GP }---~-- ~o=J 
snare" C j 
fone ! 

FUSH H PUSH I FUSH B 


Figure 3.5. The contents of the general-purpose registers are saved on the stack. 
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STACK 
| ma nn [omen en ! 
i j t {ome ! 
ene [ ------~ ~~ jenn ieau oe ! 
i H ! ! H ! ! H ! 
| ane a: ee eee ! | mmm ee | 
l L Joana | L L ; 
faa ! | ~~ pode ae ! 
! Vt t ! n ! H if] ! 
GP fmm mmr | ae ae ! poe oe | 
sam> | E i ! E ! ! E ! 
Laeiemee l | am ! eee 
} BR i i FR i t EB i 
| an a ! fener o ! ere 
! C ! ! C i i C ! 
| anna nen [ ~-- ~~~ [on a | 
FOF B FOP ft POP H 


Figure 3.6. The original contents of the general-purpose registers are restored 
from the stack. 


THE ACCUMULATOR AND PSW AS A DOUBLE REGISTER 


The 8-bit accumulator and the 8-bit flag register are treated as a 16-bit 
double register for the PUSH AF and POP AF instructions. In this case, the 
accumulator is treated like the high byte since it is pushed onto the stack 
first. The flag register is pushed onto the stack second. Figure 3.7 demon- 
strates this. 


stack stack 

6Gpo Teese ses ! ee ! 
som "> ft t ( 8 
fSaccuueet foseeien | 

! i ! A » «4 

Pee eo ee ae § GPO beeen f ! 

{ fommx> {| flads ! ! 

Bomar se se we se st i eel Reeteleatetaakel | i 

! ' 

! Be mc se ee se ! ! 

! ! A fo ine 
! Bee ses eo er { 
i-< § fleds ! 
Bee ew stem oe ! 

FUSH FSW FOF PSW 


Figure 3.7. Contents of the accumulator and flag registers are pushed onto the stack. 
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Data can be moved from one register pair to another by using a 
PUSH/POP combination. For example, the two 8080 commands 


FUSH H 
FOF th 


will move H to D and L to E. This is not the most efficient way to accom- - 
plish the move, however. The sequence requires access to main memory and 
so is slower than the direct register moves 


MOV DeH 
MOV EsL 


Z-80 INDEX REGISTERS 


The Z-80 has two, 16-bit index registers that can participate in the PUSH 
and POP operations. However, the instructions each require two bytes com- 
pared to the other PUSH and POP instructions which only require one byte 
each. As a result, the execution time is slower than the other PUSH and 
POP instructions. There are no official instructions for moving data between 
the index registers and the general-purpose registers. This transfer can be 
performed, however, by use of the PUSH and POP commands. The two 
instructions 


FUSH IX 
FOF BC 


will copy the IX register into the BC register. 


SUBROUTINE CALLS 


We have seen that the PUSH instructions can be used by the programmer to 
store data on the stack. The 8080 and Z-80 CPUs use the stack for a second 
purpose: storing the return address when a subroutine is called. Subroutines 
are used to efficiently code a set of instructions needed at several different 
places in a computer program. A subroutine is called by using the assembly- 
language mnemonic CALL. At the end of the subroutine, indicated by the 
return statement, control is automatically returned to the calling program. 


Po callimg bo mcm rene i ! subroutine |! 
1 prodram | denne ene Pam som ene sre st se a see ate sae oe f 


The input and output routines which control the console may. be 
needed at several locations in a program. Consequently, they are coded as 
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subroutines. The 8080 assembly language subroutine for the console might 
look like this. 


OUTPUTS IN STATUS § CHECK STATUS 
ANT INMSK ’ INPUT MASK 
JZ OUTFUT § NOT READY 
MOV AvE § GET DATA 
OUT DATA § SENT DATA 
RET 5 DONE 


Data can be output from anywhere in a program by placing the byte in the 
B register and calling the output subroutine. The following examples of 
8080 assembly language mnemonics show how a question mark and a colon 
can be printed by calling the console output routine. 


WHAT 3 MVI By’ ?¢ sQOUTPUT A ? 
CALL QUTFUT 


> ® ® 


¢ ° 


COLON: MMVI By’ 3% sO0UTFUT A COLON 
CALL OUTPUT 


e o e 


The above examples utilize the unconditional subroutine call and 
unconditional return instructions. Conditional call and return instructions 
are also available. These commands perform the appropriate call or return 
only if the referenced PSW flag is in the desired state. The four flags-—zero, 
sign, carry, and parity —give rise to eight conditions. 


Zero 

not zero 
plus 

minus 
carry 

not carry 
parity even 
parity odd 


These instructions are discussed in more detail in Appendix H. 

The stack provides the mechanism for subroutine operation. When a 
CALL instruction is encountered, the address immediately following the 
CALL statement is automatically pushed onto the stack. The subroutine 
address is then loaded into the program counter register. The program 
counter tells the CPU which instruction to execute next. Since a subroutine 
CALL uses the stack, the programmer must be sure that the stack is properly 
defined prior to a subroutine CALL. When a return instruction is subse- 
quently encountered, the return address is popped off the stack and placed 
into the program counter. After return from a subroutine, program execu- 
tion continues with the instruction following the CALL statement. 
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PASSING DATA IMPROPERLY TO A SUBROUTINE 


Since the stack can be used for storing both data and subroutine return 
addresses, the programmer must ensure that there are no conflicts. First, 
there should normally be as many POP instructions as PUSH instructions. 
Second, one must be careful not to PUSH data onto the stack, CALL a sub- 
routine, then POP data off the stack. The LIFO nature of the stack will 
cause trouble in this case. 


PUSH H 
CALL ORDER >---! 
¢ ¢ ® ! 


¢ o ? { 


ORDERS 6 6 « rere 
POF H 
¢ + ° , 
RET ema? PPP? CRASH ! 


Figure 3.8 shows an example of improper mixing of data and the return 
address on the stack. Higher memory is upward and lower memory is down- 
ward. The arrow indicates the current stack pointer position. 


STACK 

SF Be me a ee et oe }  Reotealeedealententonieateed PGR Dee nem ! 
=o ! data ! ! data f ===> ! data ! 
oleseeesnenenteted 1 GP fewer eee i [Soar Sse-= ! 

man> | address ! 

Piso cs as nce 1 
! Pam ae vn ae es seo ate 
Pmmem i Heb ! address ! 
| eae pearen pares 1 

PUSH H CALL ORDER POF H RET 


Figure 3.8. Improper mixing of data and the return address on the stack. 


In this example, the data is first pushed onto the stack while in the main 
program. The return address is then pushed onto the stack next, when the 
CALL instruction is encountered. The POP instruction in the subroutine will 
actually load the HL register pair with the subroutine return address rather. 
than the data that was expected. This occurs because the data was pushed 
onto the stack before the return address. Worse yet, the RET instruction will 
load the program counter with the data, rather than with a useful address. 
Strange things are likely to happen when the CPU attempts to execute 
instructions at an address defined by the data. 


PASSING DATA PROPERLY TO A SUBROUTINE 


This section demonstrates a proper way to pass data into a subroutine by 
using the stack. The task can be accomplished with the 8080 XTHL instruction 
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or the Z-80 EX (SP),HL instruction. This operation exchanges the HL 
register pair with the two bytes at the current stack position. The instruction 
is analogous to the X/Y EXCHANGE key on an HP calculator. 
| The method works in the following way. The data is pushed onto the 
stack while control is in the calling program. When the subroutine is called, 
the return address is pushed onto the stack, just after the data. A POP 
instruction, executed in the subroutine, delivers the return address to the HL 
register. Now, the XTHL instruction exchanges the HL register with the 
stack. The desired data is now in HL and the return address is on the stack. 
Finally, a return instruction will correctly return control to the calling 
program. 


“a> 


PUSH H main Frodram 
CALL ORBER § call subroutine 


ORTER? * 6 6 * start of subroutine 
POF H § get return address 
5 


XTHL exchansde with data 
2 e ¢ 
RET § return to main rrodgram 
STACK !---~-----~ PGP bw eee ee ! SP i---~~----. ! 
! data [ see> | data fo =see> ! address ! 


CALL . POP H XTHL RET 


Figure 3.9. Proper mixing of data and return address on the stack. 


It is important to note that the XTHL command only works with the 
' HL register. There is no equivalent instruction for the DE or BC registers. 
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PASSING DATA BACK FROM A SUBROUTINE 


A variation of the XTHL technique is also possible. Data can be pushed onto 
the stack from within a subroutine, then retrieved after returning to the 
calling program. 


CALL FETCH 
FOP H sGET THE DATA 


¢ > e 


FETCH? «6 o» ¢ 


LXI HsDATA #PUT IN Hoel 
XTHL §SWITCH STACK 
PUSH H sRET ADDR 

RET 


stack stack, 
GSP bee ee mee EEL | a oolotoatenteatentententon ! 
amo> | gddress { ===> |! data { 
tes scientist oe ean ! (aes ! 
 odententoakeaeanenenl ! Fem me et a re st ee i 
HL 1 date ! ! gddress ! 
tseon.soue ! Pte ete i 
CALL XTHL 
STACK 
i leateeleteteaetoaton BPR Emer rene ee tt ce ses i 
|! 6 6date fomen> § data i 
SF  leatenlantemteaetetonl j Bre me ee cm se re ! 
om om mt} ! address ! 
| em | 
PUSH H RET 


Figure 3.10. Using the stack to pass data back from a subroutine. 
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An extension of the XTHL technique allows additional data to be 
passed on the stack. 


CALL FETCH 


POP B sDATA 3 
POP D sDATA 2 
1 


POF H #DATA 


+ @ e 


FETCH? + « » | 
LHLD DATAL #DATAL TO Heb 


XTHL sSWITCH STACK 

XCHG sSTACK TO DE 

LHLD DATA2 sGET DATA2 

PUSH H sPUT ON STACK 

LHLD HATAS sGET DATAS 

PUSH H sPUT ON STACK 

PUSH i SRET ADDR TO STACK 
RET 


In this example, the return address is first moved to the HL pair with the 
XTHL command. Then it is moved to the DE register pair with the XCHG 
instruction. Three sets of 16-bit data are obtained from the memory ad- 
dresses pointed to by the arguments of the LHLD instructions DATA1, 
DATA2, and DATAS. The first set is placed on the stack with the XTHL 
command. Then the other two are pushed onto the stack. Next, the return 
address, previously saved in the DE register pair, is pushed onto the stack. A 
final RET instruction pops the return address from the stack into the pro- 
gram counter. 


SETTING UP A NEW STACK 


Sometimes it is desirable to save the current stack pointer and set up a new 
one. When this happens, the original stack pointer is restored at the conclu- . 
sion of the task. The technique is particularly useful when one independent 
program is executed by another. The original stack pointer is saved in a 
memory location, then retrieved at the end of the program. 

If the current program was reached through a subroutine call, the 
return address for the calling program should be the current address on the 
- original stack. It is this address that must be saved. 

There is a Z-80 instruction that allows the old stack Seinies to be 
stored directly in main memory. The instruction looks like this. 


—§ Z-80 VERSION 
3 


START? LOD COLESTK) »SP Ssave stack 
Lf SP*eSTACK fnew stack 
@ ¢ 6 
LD SP,(OLDSTK) ¢set old stack 


RET done 
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At the conclusion of the task, the old stack pointer is restored. With an 
8080 CPU, the job is more complicated since the stack pointer cannot be 
directly saved. In this case, the stack pointer is moved to the HL register 
pair which is in turn saved in memory. This is done by first zeroing HL, then 
adding in the stack pointer. At the end of the routine, the old stack pointer 
is loaded into the HL register pair then copied into the stack pointer register. 
Finally, a RET instruction is given. 


START? LXE Hed Szero HL 
TAL SP §SP to HL 
SHLII OLDSTK Save stack 
LXI SP°eSTACK fnew stack 


¢ 9 > 


LHLD OLDSTK set old stack 
SPHL. grestore stack 
RET 


CALLING A SUBROUTINE IN ANOTHER PROGRAM 


A program may need to call a subroutine that resides in another program. 
But if the second program is revised, the subroutine address in the second 
program will change. This means that the argument of the CALL statement 
in the first program will also have to be changed. 

There are two ways to solve this problem. One method is to provide a 
jump instruction near the beginning of the second program. The address of 
the jump instruction will always be the same. However, its argument, the 
internal subroutine address, can change from one version to the next. The 
first program simply calls CHEK2, and CHEK2 causes a jump to CHEK, the 
desired subroutine. The RET instruction at the end of CHEK will effect a 
proper return to program 1. 


FProdram i 


¢ oo ¢ 5 
Pome me se em set es CALL CHER? ' call Frodram 2 
! > 8 6 ee ee ae ee ee ! 
f e 8 ¢ , 
! START? JHF CONTIN Sstart of Program 2 
'—> CHEK23 JMP CHEK | 


i 
' 
! 
! ! 
! 

< | 1 
RET §to Program Lo em mn | 


Of course, the second program may need to save the incoming stack, then | 
restore it before returning to program 1. 

A second solution is to place just the two-byte address of the subrou- 
tine near the beginning of the second program. 


START: JMP CONTIN #¢ Program 2 
CHEK2¢ DW CHEK 


te ntttnenretteetttnsinenttenennnent 
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Now the calling program must put its own return address on the stack and 
get the address of CHEK into the program counter. The following example is 
a way to do this. Notice that program 1 does not enter program 2 with a 
CALL instruction. It uses instead the PCHL instruction which copies the 
~ contents of HL into the program counter. 


FUSH H sSAVE Hel. 

LXI HeNEXT RET ADDR 

PUSH 4H sONTO STACK 

LHL CHEK2 

PCHL sINTO PC 
NEXT? POF H sO0RIG Hel 


CALLING ONE SUBROUTINE FROM ANOTHER 


A subroutine called by a main program may in turn call another subroutine. 
When the first subroutine, SUB1, is called, the return address to the main 
program, MAINA, is pushed onto the stack. When the second subroutine, 
SUB2, is called, the return address SUB1A is next pushed onto the stack. 
After the second subroutine has been called, there will be two return ad- 
dresses on the stack: one to get back to SUB1 from SUB2, and the other to 
get back to the main program from SUB1. 


CALL SUBI gMAIN 
MAINA? ¢ 8 @¢ meee | 
¢ SUBROUTINE 1 


7 
SUB1L: oe 6 


i 
! 
i 
! 
CAL SUB2 ! 


+83] 
Cc 
b> = 
eh. 
p> 


e e + 


i 
RET tee 


SUBROUTINE 2 


£9 cr sae sae 


UB2i 4 4 
RET penne 
STACK 
a | n nn a) ee eee ! 
===> ! MAINA ! |! MAINA |! ===> | MAINA ! 
Ya a PGP peewee Pe a tt i 
sam> | SUBIA ! 
| aan 
CALL SUB1 CALL SUB2 RET RET 


Figure 3.11. One subroutine calls another. 
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BYPASSING A SUBROUTINE ON RETURN 


It may be that an operation in the sectond subroutine SUB2 makes it desir- 
able to return directly to the main program from SUB2, bypassing SUB1. 
This is easily accomplished if the stack pointer is raised by two bytes before 
executing the return instruction. Of course, care should be taken to see if 
data has been pushed onto the stack after one or both return addresses were 
placed on the stack. The one-byte instruction to increment the stack pointer 
(INX SP) can be executed twice, to raise the stack pointer two bytes. Alter- 
nately, a one-byte POP command can be used if there is a free register pair 
available. 


STACK 
pesewsases i SSB Weesececas ' 
1 MAIN2 ! ===> ! MAINZ ! 
SP Be ws re ) eta ae ' 
zam> ! SUBIA ! 
{sees ee ! 
CALL SUB2 FOP H RET 


Figure 3.12. Skipping one level of subroutine during the return. 


Suppose that an ordinary return from subroutine SUB2 back to sub- 
routine SUB1 is desired if the zero flag is set to 1. On the other hand, an 
unusual return directly back to the main program is desired if the zero flag 
is reset to a value of zero. Here is a way to do this. 


CALL SUBI 3MAIN 
MAINI? ¢ © ¢ ee | 


% a > =) 
§ SUBROUTINE 1 
3 


SUB1L: ¢ 6 © SSUBROUTINE i 
CALL SUR2 cane! 
SUBIAS +. o »« 
RET ; 


! 
j 
! 
SUBROUTINE 2 ! 
! 
i 
! 


! 
! 
! 
! 
! 
! 
! 
i 
! 
! 
! 
! ! 
RZ gNORMAL RETURN >- ! 
t 
t 


POP PSW SRAISE STACK ! 
RET gSKIP TO MAIN 3----~ 


The POP PSW instruction raises the stack two bytes so that the final 
RET instruction delivers the return address of MAIN1 to the program 
counter. This effectively bypasses the intermediate subroutine. 
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A PUSH WITHOUT A POP 


Near the beginning of the system monitor, explained in Chapter 6, there is a 
restart address called WARM. The program normally branches back to this 
point at the conclusion of each task. Thus the final instruction of each task 
_could be: : 


JMP WARM 


A more efficient method, however, is to push this restart address WARM 
onto. the stack at the beginning of the task. Then if the task does not termi- 
nate within a subroutine, a simple return instruction, rather than a jump, can 
be given at the end of the task. This causes a branch back to WARM. 


¢ e ¢ 


OPORT? . « « | 
RET a an ae ! 


WARM? LXI HyWARM ¢Hel = HERE <----! 
FUSH H yONTO STACK ! 
® e + ! 
¢ ¢ ¢ J 
JZ OPORT ! 

: § 
' 


This example is an exception to the rule that we should have a POP instruc- 
tion for every PUSH. Here, there is a PUSH but no POP. Of course there is 
also a RET with no CALL. So everything is all right—or is it? What happens 
if termination occurs from a subroutine? | 


GETTING BACK FROM A SUBROUTINE 


Ifa particular task terminates in a subroutine, then this subroutine’s return 
address must be popped off the stack (or an INX SP instruction must be 
executed twice) before the return is issued. 


WARK? o 6 ¢ mee ee coe ee ee eee ne ne ae i 
. JZ DUMF 


o e e 


DUMP ? e © @ ; 
CAL TSTOF 


e @ 6 s 


TSTOPS »« «© « ! 


‘ 
1 
j 
H 
i 
I 
i 
i 
i 
i 
j 
i 
j 
H 
I 
H 


RNC SNORMAL RETURN >-! 
FOF H yRAISE STACK 
RET >TO WARM Per Sees { 


The stack pointer grows downward through memory during use. It is 
therefore common practice to place the stack as high as possible in available 
memory. But the system monitor may be located at the actual top of mem- 
ory. In this case the stack can initially be placed lower in memory at the 
beginning of the monitor. 
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START? 
LXI SP e START 


On the other hand, the monitor may be placed in read-only memory (ROM). 
In this case, the stack can be located at the actual top of read/write memory. 
(While both read/write memory and ROM are random-access memory— 
RAM, it is customary to refer to read/write memory as RAM and read-only 
memory as ROM. This convention will be followed here.) 


AUTOMATIC STACK PLACEMENT 


The placement of the stack at the top of RAM can be done automatically, so 
that the total amount of RAM can be changed without having to reprogram 
the PROM monitor. A short routine can test each block of memory starting 
at zero until it finds a location that can’t be changed. The stack is then put 
at the beginning of this block. Remember, the stack pointer is always decre- 
mented before use; therefore, it can be initially defined as one location 
above usable memory. 

The first part of the program is a memory search routine that starts at 
address zero. It moves the byte from that location into the accumulator, 
complements it, then moves the complemented byte back to the original © 
location. A comparison is made to see if the memory location does indeed 
contain the complemented byte. If it does, the accumulator is comple- 
mented back to the original byte and returned to memory. Such an algo- 
rithm is often called a nondestructive memory test. | 

The first byte of each subsequent block of memory is checked in this 
way until a failure is found. This will usually reflect the top of usable mem- 
ory, but of course, it could indicate defective memory. The Followale pro- 
gram will work properly if placed in read-only memory. 


ROUTINE TO AUTOMATICALLY PLACE THE 
STACK AT THE TOP OF MEMORY 


“S> “Gp “Go “o> “dp 


8080 CODE 

LXI HO ©  $FIRST ADDR 

NEXTP3 MOV Arh gGET BYTE 
CMA § COMPLEMENT 
MOV Mv sPUT IT BACK 
CMF M 3 COMPARE? 
JINZ TOP sNOe DONE 
CMA 3BACK TO ORIG 
MOV MerA sPUT IT BACK 
INR H gNEXT BLOCK 
JMP NEXTF ®KEEP GOING 

3 

TOP: SPHL sSET STACK 


CALL OUTHL SPRINT IT 
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This program might not work, however, if it is placed in read/write memory. 
The problem occurs because the routine is changing various locations in 
memory. If it happens to change its own instructions, then the results will 
be unpredictable. 

The shortcomings of the previous program are solved with the follow- 
ing version. The improved version will operate properly no matter where it 
is placed. The stack will be placed at the top of contiguous RAM unless the 
routine itself is in that part of memory. In that case, the stack will be placed 
at the beginning of the program. The Z-80 version is shown, but the program 
can be run on an 8080 if two minor changes are made. The relative jump 
instruction must be changed to an absolute jump and the DJNZ instruction 
must be changed to the equivalent DCR B and JNZ combination. 


¢ STACK AT THE TOP OF MEMORY 


5 
$ ROUTINE TO AUTOMATICALLY PLACE THE 
, 
§ FAILSAFE VERSION (Z-80 CODE) 


START: LD HL» 0 §START CHECK AT 0 
LD BeSTART SHR 8 
NEXTP? LOD AvyCHL) §GET BYTE 
CPL . sCOMPLEMENT IT 
Li (HL) »A sPUT IT BACK 
Cr CHL) #bID IT GO? 
JR Z» TOP §NO» DONE 
CPL sBACK TO ORIG 
LD (HL) »A sRESTORE 
INC H §NEXT BLOCK 


DINZ NEXTP SARE WE HERE? 


TOP: Lo SP oHL §SET STACK 


The new version works in the following way. The B register initially 
contains the block number of the routine itself. The value in B is decre- 
mented as each successive block is checked. If the routine is in ROM, then 
the end of usable memory will be found, as in the previous version. The 
program will loop between the label NEXTP and the DJNZ NEXTP instruc- 
tion. At some point, the CP (HL) instruction will reset the zero flag and the 
computer will jump to the address of TOP. The stack will then be placed at 
the top of RAM. 

Alternately, if this routine is placed in the lower memory area, then the 
DJNZ instruction will decrement the B register all the way to zero. The zero 
flag will be set and the program will move on to TOP. Now the stack will be 
set to the beginning of the memory block that contains the program itself. 

‘The START SHR 8 expression at the beginning of the routine instructs 
the assembler to calculate the high byte of the address of START and make 

it the second operand of the LD B instruction. It does this by shifting the 
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address of START by eight bits to the right, then taking the low-order eight 
bits of the result. Some assemblers allow an equivalent operand of 


HIGH START 


which is easier to comprehend. This automatic stack routine is incorporated 
into the system monitor explained in Chapter 6. 


CHAPTER FOUR 


Input and Output 


Computers would not be very useful if they could not interact with the 
outside world. Commands and data are sent to the computer from the key- 
board, magnetic tape, disk, and other peripherals. Results of computations 
are sent back from the computer to the printer, video terminal, tape unit, 
disk, and so on. Such input and output (I/O) transfers on a microcomputer 
are typically accomplished through special memory locations called I/O 
ports. One type of port is distinctly different from main memory. The other 
_ type of arrangement utilizes one of the regular main memory locations. The 
peripheral in this latter case is then said to use memory-mapped I/O. Each 
method has advantages and disadvantages. In either case, the I/O port will 
transfer eight bits, the natural word size for the 8080 and Z-80 CPUs. 


MEMORY-MAPPED I/O 


The I/O instructions on the 8080 microprocessor are rather limited com- 
pared to memory operations. There is a single IN and a single OUT instruc- 
tion for transferring eight bits of data. In contrast, there is a much larger 
collection of memory operations available. 


(8080 Mnemonics) (Z-80 mnemonics) 
STA 80 LD (80) 9A 
LDA 81 LD Ay (B81) 
MOV Mec LD (HL C 
STAX D Li (BE) A 
SHLD 84 LD (84) HL 


These additional instructions can be utilized with memory-mapped I/O, 
greatly increasing the versatility of the Z-80 and 8080 I/O operations. 


48 
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The STA instruction stores the 8-bit accumulator value at the memory 
address specified by the operand. If this address corresponds to a memory- 
mapped port, then the byte is sent to the peripheral. The LDA command 
reverses the operation. It can be used to input a byte from a port. The 
MOV M,C instruction can be used to transfer a byte from the C register to 
the memory location designated by the HL register pair. The STAX D com- 
mand moves a byte from the accumulator to the memory location desig- 
nated by the DE register pair. The SHLD instruction opens a new dimension. 
Since this operation transfers 16 hits of data from the HL register pair 
directly into two consecutive memory locations, two adjacent ports can be 
simultaneously serviced. 

The typical video console is a serial device that uses distinct ports. 
However, memory-mapped controller boards are commerically available. In 
this case, an ordinary TV set is then used for the video screen. There are also 
disk-controller boards that use memory-mapped operations to communicate 
with the disk drives. It is interesting to note that the Motorola 6600 CPU 
performs all of its I/O by memory mapping. There are no separate input or 
output instructions for this CPU. 


DISTINCT DATA PORTS 


Data ports may be designed to operate either in parallel or in serial fashion. 
Both the parallel and the serial I/O ports are connected to the computer 
through the system bus by a set of eight data lines. In addition, the parallel 
port is connected to the peripheral by another set of eight data lines. The 
serial port, by contrast, has only two data lines connecting it to the peripheral. 

For some peripherals, such as a printer, data is transferred in only one 
direction. For others, such as the console and magnetic tape units, the 
peripheral is able to both send and receive data. In this latter case, there will 
be 16 data lines between the computer and the peripheral if a parallel port is 
used. Hight lines are used for sending data and eight are used for receiving 
data. The serial port, in contrast, will have three signal lines to the peripheral 
if there is two-way communication. One is for transmitting, one is for 
receiving, and the third is a common line for the other two. 

There may be additional lines between the computer and the periph: 
eral. One of these might indicate to the computer whether the terminal is 
operational. Another can be used to inform the terminal that the computer 
is ready. These extra lines are sometimes referred to as handshake lines. 

The computer usually operates at a much higher speed than the periph- 
erals. Consequently, there must be a mechanism for effectively slowing down 
the computer during I/O operations. For serial or parallel ports, this is 
typically accomplished by using two separate I/O ports for each peripheral 
device. One port is used for the data port and the other is used for the status 
port. Each of these two ports will have distinct addresses, one of the 256 — 
values available to the 8080 or Z-80 CPU for this purpose. There are three 
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general methods of performing I/O through data ports: looping, polling, and 
interrupting. 


LOOPING 


Looping is the simplest method of performing I/O through separate ports, 
and it is the one that is most commonly employed in 8080 and Z-80 pro- 
grams. The CPU performs output by sending a byte to the data port using 
the OUT instruction. The corresponding status port is then read with an IN 
instruction. One bit of the 8-bit status port reflects the condition of the 
corresponding peripheral. 

When the CPU places a byte in the data register, using the OUT com- 
mand, the output status bit of the status register is set. This may actually 
result in a logical 1 or a logical zero, depending on the port design. When the 
peripheral utilizes the byte that was placed into the data register, the output 
status bit of the status register is reset. These changes in the status bit are 
automatically handled by the I/O interface hardware. However, the program- 
mer must include in the software the appropriate routines for monitoring 
the status bits. 

As an example of the looping method, consider the following sub- 
routine: 


COUT: IN 10H §CHECK STATUS 
ANI 2 sSELECT BIT 
JZ COUT SNOT READY 
MOV ArC sGET BYTE 
OUT 11H ’SEND 
RET § DONE 


This routine could be used to send a byte of data to the system console. The 
first instruction of the listing causes the CPU to read the 8-bit status port 
which has the address of 10 hex. The second instruction performs a masking 
AND operation to select the write-ready bit, bit 1. Remember that a logical 
AND with zero and anything else gives a result of zero. However, a logical 
AND with unity and a second logical value, gives the result of that second 
value. 

Suppose that the output status is indicated by a logical 1 of bit 1, where 
bit O is the least-significant bit of the register. Then, a logical AND with the 
value in the status register and with the number 2 will result in a logical 1 if 
the peripheral is ready. If the device is not ready, however, the result is a 
logical 0. 


0101 O111 status 0101 0101 
AND. 0000 0010 = 2 0000 0010 
0000 0000 0000 0010 


ready not ready 
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Thus, the logical AND with the value of 2 in the status register gives a result 
of zero if bit 1 (the second bit) is 0. Otherwise, a nonzero result is obtained. 

The third instruction in the looping example is a conditional jump. If 
the peripheral is not ready, the JZ instruction will cause the computer to 
loop repeatedly through the first three lines until the peripheral is ready for 
another byte. At this point, the write-ready bit, bit 1, will be a logical 1. 
Then the logical AND operation, the second instruction of the subroutine, 
produces the nonzero value of 2. The MOV instruction following the condi- 
tional jump will then be executed. The byte to be outputted is moved to the 
accumulator, and then sent to data port 11 hex by use of the OUT command. 

When the byte to be output is actually sent to the data port, the write- 
ready flag is reset to a logical zero. The output routine may be immediately 
reentered for outputting another byte, but now the peripheral is not ready. | 
Looping will occur again through the first three instructions of the output 
routine since the write-ready flag has been reset to zero. : 

The CPU clock may be operating at 2 or 4 MHz. This rate is thousands 
of times faster than the speed of a typical printer. Consequently, if the 
looping method is used, the CPU will be spending over 99 percent of its time 
simply looping through the first three lines of the output subroutine. The 
computer will be spinning its wheels, so to speak, waiting on the peripheral. 

Because the CPU is operating so much faster than the peripherals, it 
can, in principle, service many peripherals simultaneously. A very simple but 
useful implementation of this idea is found on the CP/M* operating system. 
In the CP/M system,* console output is normally sent only to the console. 
This terminal is typically a high-speed video device. But if the user types a 
Control-P, then the list device is also turned on. Console output will now 
appear simultaneously at both the console and the line printer. 

This technique can be easily observed if the console video accepts data 
much faster than the line printer. Normally, as data is sent only to the con- 
sole, it appears rapidly on the video screen. But when the list device is. 
turned on, the output appears much more slowly. The reason for the slow- 
down is that both peripherals are operating at the speed of the slower one, 
in this case the printer. . 

A subroutine for accomplishing such a dual output might look like this. 


LOUT: IN LSTAT ‘LIST STATUS 
ANI 2 sOUTFUT MASK 
JZ LOUT SLOOP UNTIL READY 
MOV A»C ®GET THE BYTE 
OUT LDATA sSEND TO LIST 
OUT CHATA SAND CONSOLE 
RET ’ DONE 


*CP/M is a registered trademark of Digital Research, Inc., Pacific Grove, California. 
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This routine is not the one that is actually used in the CP/M system since, 
with our routine, the console will always display everything that is sent to the 
printer. This feature does not increase printing time as long as the console 
operates faster than the printer. Notice that there is no need to check the 
console status register. The output rate is set at the speed of the printer, and 
so the console, which operates so much faster, will always be ready if the 
printer is ready. 


POLLING 


One way to improve the performance, or throughput, of a CPU is with a 
technique known as polling. In this method, the CPU sends a byte to each of 
several different peripherals. Each peripheral operates at its full speed. 
Polling is more efficient than the looping method, and has been incorporated 
into several commercial 8080 software products. One product is a multiuser 
BASIC which can service up to four separate consoles. Each user can inde- 
pendently perform calculations using the same BASIC interpreter. 

Another product that uses the polling technique is known as a spooler. 
The looping method is typically utilized for all output. In this case, all other 
activities must be halted while the printer is working. With a spooler pro- 
gram, however, things are different. When this program is incorporated into 
the system, the user can perform other tasks using the system console while 

_adisk file is being printed. 

In the polling method, the I/O routines are somewhat different from 
the corresponding routines of the looping method. The output-ready flag of 
the status register is checked periodically as with the looping method. But if 
the status flag indicates that the device is not ready, the CPU returns to per- 
form some other task. Thus, the CPU does not waste time looping around 
the first three instructions of the input or output routine. A typical output 
routine using the polling method might look like tihis. 


LOUT: IN LSTAT gCHECK STATUS 
ANI LMASK §MASK FOR OUTPUT 
RZ §NOT READY 
MOV ArvC §GET THE BYTE 
OUT LDATA sSEND IT 
RET 


While the polling method is a great improvement over the looping 
method, there are still problems. For example, a decision must be made as 
to how often each status register will be polled. An even better method is to 
use hardware interrupts. 


HARDWARE INTERRUPTS 


The 8080 and Z-80 microprocessors incorporate a hardware interrupt system. 
This feature allows an external device, such as the system console or printer, 
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to interrupt the current task of the processor. When the CPU is interrupted, 
it suspends its current task, and calls on one of several memory locations set 
aside for this purpose. The CPU services the request of the interrupting | 
peripheral, then it returns to its previous task. 

In this method, the CPU does not have to be programmed to check the 
peripherals on a regular basis as with the method of polling; nor does it have 
to waste time in a loop. Instead, the peripheral interrupts the processor when 
it needs service. If several peripherals are able to interrupt the CPU, then 
there must be a method for prioritizing the requests. This ordering is accom- 
plished through a vectored interrupt system. For example, if a lower- -priority 
device has interrupted the CPU for service, this phase can also be interrupted 
by a peripheral with a higher priority. On the other hand, a device with a 
lower priority cannot interrupt a higher-priority service, but must wait 
its turn. 7 
Usually, the highest-priority interrupt will be assigned to updating the 
system clock. If the computer misses a beat, then the time will be incorrect. 
The next lower priority could be assigned to disk transfer. The printer could 
have a low priority since it is a relatively slow device, and it won’t matter if 
it must slow down every so often. 

Suppose that the printer is operated by interrupts rather than by loop- 
ing or polling. The computer sends a byte to the printer, then continues with 
another task. When the current byte has actually been printed, the printer 
interrupts the CPU for another byte. In the time between the poaane of 
two bytes, the CPU can perform many other tasks. 

The console keyboard is another peripheral that can be deathly serviced 
by an interrupt system. In this case, each time the user presses a key, the 
CPU is interrupted from its current task. Of course, if the CPU is currently 
servicing a higher-priority interrupt, then the console keyboard request will 
have to wait. 

Both the 8080 and the Z-80 allocate eight addresses that can be used 
for the interrupt service routines. These addresses can be called by the eight, 
one-byte RST instructions. 


Z-80 8080 Instruction code Call 
mnemonic mnemonic hex binary address 
RST OOH RST 0 C7 1100 0111 00H 
RST 08H RST 1 CF 1100 1111 08H 
RST 10H RST 2 D7 1101 0111 10H 
RST 18H RST 3 DF 1101 1111 18H 
RST 20H RST 4 E7 1110 0111 _ 20H 
RST 28H RST 5 EF 1110 1111 28H 
RST 30H RST 6 F7 1111 0111 30H 
RST 38H RST 7 FF 1111 1111 38H 


These instructions can be used as one-byte subroutine calls. As an example, 
suppose that the CPU executes an RST 5 instruction which corresponds to 
the instruction code EF hex. A subroutine call is then made to the corre- 
sponding address of 28 hex. The return address is pushed onto the stack, 
ee ec A ee Se 
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just as for a regular subroutine call. Subsequent execution of a return instruc- 
tion will cause the program flow to return to the instruction immediately 
following the RST 5 instruction. 

Hardware interrupts operate by emulating the software RST call. When 
an interrupt occurs, the CPU automatically disables the interrupt flip-flop, 
thus further interrupts are prevented. Then a subroutine call is made to the 
corresponding call address. This is done by jamming the desired RST code 
onto the data bus. The simplest implementation is to use a single interrupting 
device and the RST 7 instruction. (A normal interrupt always performs an 
RST 7.) The interrupting peripheral momentarily changes the state of the 
interrupt-request bus line. For the S-100 bus, this would require that bus line 
73 be pulled to a zero-voltage state from the usual 5-volt level. The CPU 
responds by automatically calling memory address 38 hex. The programmer 
will have previously placed the service routine at this location. The service 
routine will conclude with a command to re-enable the interrupt flip-flop. 
Then a return instruction will be executed. 

The trouble with this simple approach is that the RST 7 call to location 
38 hex interferes with system debuggers because they also use this address. 
~ Consequently, another interrupt level is more suitable. Unfortunately, a 
single interrupt system always calls the RST 7 location. One solution to this 
problem is to use a vectored interrupt board. A vectored interrupt board 
allows the user to select up to eight separate interrupt levels corresponding 
to the RST 0 to 7 instructions. The disadvantage of this approach is the 
cost, since a vectored interrupt board may sell for several hundred dollars. 

However, there is a low-cost solution. If only one interrupt level is 
required, a single hardware interrupt can be converted from an RST 7 to 
some other level such as an RST 5 by using only two logic gates. The circuit 
shown in Figure 4.1 will make the needed translation. The output of the 
two-input NAND gate IC-1 goes low when both of the input lines are high. 
One of these inputs is SINTA, line 96 on the S-100 bus. It is a CPU status 
signal that indicates acknowledgment of the interrupt request. The other 
input is PDBIN, bus line 78. This signal indicates that the data bus is in the 
input mode. 


8T97 


14 13 
ee bi 
SINTA = P 15 
: 3 
heal) 
OO 
2 
EDEN 7400 


Figure 4.1. Circuit to convert an 8080 interrupt to an RST 5. 


When the output of IC-1 goes low, it turns on the three-state buffer 
IC-2. This pulls the data-input bus line DI4 low. Since the remaining seven 
lines of the data-in bus are high, the CPU will see the value of 


1110 1111 


INPUT AND OUTPUT 55 


Notice that this is the bit pattern for the RST 5 instruction. The result is 
that the CPU executes an RST 5 instruction, by calling address 28 hex. The 
interrupt service routine, or a jump to it, is placed at this address. 


AN INTERRUPT-DRIVEN KEYBOARD 


We have seen that a printer operates considerably slower than a CPU.:The 
console keyboard is even slower than the printer, especially if the operator 
is not an expert typist. Conversion to an interrupt-driven keyboard will 
considerably increase the effectiveness of a computer. 

Characters entered on an interrupt-driven keyboard are leiagotaiic 
stored in a memory buffer area. Each time a key is pressed on the console, 
the CPU is interrupted from its current task. The new byte is read and 
placed into the keyboard buffer. The computer then returns to its prior task. 
When the computer needs console input, it gets it from the input buffer, 
rather than from the console itself. 

An interface program, utilizing a keyboard-interrupt approach, is 
shown in Listing 4.1. This program provides the necessary routines for 
interfacing the Lifeboart version of CP/M to a North Star disk system.* The 
portions of the program which specifically utilize the interrupt routines 
begin with a row of asterisks and end with a row of semicolons. 


Computer Computer Keyboard Keyboard 
: : Buffer 
pointer count count pointer F406 


F400 F402 F403 F404 


Figure 4.2. The input buffer and pointers. 


The layout of the memory buffer with its pointers is shown in Figure 
4.2. The buffer area is arbitrarily chosen to start at the address of F400 hex. 
The location can be anywhere above the CP/M operating system. There is 
only one keyboard buffer, but there are two sets of pointers: one for the 
CPU and one for the keyboard. Two counters are also utilized; one shows 
how many characters have been entered from the keyboard and the other 
shows how many have been read by the computer. Since both sets of pointers 
grow larger, they need to be reset periodically. The two pointers are com- 
pared after each carriage return. If they are the same, then they are both 
reset to the beginning of the buffer. 

Suppose that this interface program is incorporated into your system. 
CP/M might be printing something on the console video screen when a key 
on the console is pressed. A hardware interrupt will occur, causing the com- 
puter to stop its task and call address 28 hex (RST 5). A jump instruction at 
address 28 hex will transfer control to subroutine KEYBD. The keyboard 


*Lifeboart Associates, 2248 Broadway, New York, N.Y. 10024. 
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Listing 4.1. Interrurt driven keyboard, 
TITLE ‘Interrurt CP/M BIOS’ 
(Put today’s date here) 


LIFEBOAT VERSION WITH OFTION FOR 
EITHER SINGLE OR DOUBLE DENSITY 


TERMINAL DEVICES SUPPORTED: 


a> “Sp > th UP “SP “iP > “HP “SP “EP OG: 


CONSOLE 10 HEX CON: 
LIST- 12 HEX LST; 
FHONE MODEM 14 HEX FUN? - 
0000 = FALSE EQU 0 
FFFF = TRUE EQU NOT FALSE 
5 
FFFF = QOUBLE EQU TRUE sNOURLE DENSITY 
FFFF = INTRM EQU TRUE SINTERR VERSION 
? 
IF NOUBLE 
0036 = MSIZE EQU 4 sDECIMAL K 
Né00 = BIOS EQU MSIZEX1024-200H 
DBOO = USER EQU BIOS+500H 
4900 = OFFSET EQU L1FOOH-BIOS 
ELSE *SINGLE DENSITY 
MSIZE EQU u6 
USER EQU MSIZEX1024-700H 
ENDIF 
0003 = IOBYTE EQU 3 §I1/0 SETUF 
ooon = CR EQU ODH SCARRIAGE RET 
QO00A = LF EQU OAH sLINEFEED 
O000C = FREED EQU 12 sFORMFEED 
0003 = CTRC EQU 3 §°Ce KILL SCROLL 
0004 = CTRD EQU 4 9"Dy EMPTY BUFFER 
ooll = CTRQ EQU 17 §°Qs SCROLL 
0013 = CTRS _ EQU 19 “Se FREEZE SCROLL 
9 
IF DOUBLE 
§ FATCH DIATE 
DSB. ORG BIOS-100H+tOB1iH 
ELSE 
ORG USER-SOOHTOAFH 
ENDIF 
NSB1 2E44é65 tb ‘Jan 28°80’° $PATCH DATE 
5 
TkOO ORG USER 
y 
0010 = CSTAT EQU 10H sCONSOLE STATUS 
Oo011 = CLATA EQU CSTAT+1 sCONSOLE DATA 
0001 = CIMSK EQU 1 §INFUT MASK 
0002 = COMSK EQU 2 SQUTFUT MASK 
0012 = LSTAT EQU 12H sLIST STATUS 
0013 = LIWATA EQU LSTAT+1 sLIST DATA 
0001 = LIMNSK EQU 1 gINFUT MASK 
0002 = LOMSK EQU 2 POUTFUT MASK 
0000 = LNULL EQU 0 gLIST NULLS 


HOH OHO OH 


hou ow ou 


0095S = 


F400 
F400 
F402 
F403 
F404 
F406 
0005 


TROO 
TEROS 
DROS 
DRO? 
DBOC 
[TtROF 
liki2 


DBAS 
DRL? 
R19 
BAB 
DeBiL 


DNBIF 


DBS1 


HOH H OH WOH Ht 


C3iS0R 
C3ABIE 
CSNSIE 
C3L20C 
C3260C 
C3480C 
C3USIE 


3E03 
310 
N3i2 
SEIS 
312 


SE9S 


ngio 


MSTAT EQU 
MIATA EQU 
MIMSK EQU 
_MOMSK EQU 


“I> “Gb “Xt: 


14H 
MSTAT+1 
40H 
80H 
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sMODEM STATUS 
*MODEM DATA 
*INFUT MASK 
SOUTFUT MASK 


INITIALIZE FORTS FOR COMPUTINE BOARD - 


ALATA EQU OC4H 

ACONT EQU ADATAt1 

BIATA EQU ALATA 

RCONT EQU ALATAtS 

3 

COCCI CO OR OCR CRO CO CHO OK 
IF INTRM gINTERRUPTS 

STOF EQU 9SH gSET FOR INTERR 

3 

§ CONSOLE INFUT-~BUFFER LOCATION 

3 

BUFFER EQU OF400H FINFUT BUFFER 

CFNTR EAU BUFFER sCOMFUTER FOINTER 

CCNT EQU CENTR+2 sBRUFFER COUNT 

KONT EQU CONT+1 $§KEYBRDE BUFF COUNT 

KF NTR EQU KCNT+1i sKEYBOART FOINTER 

BUFF EQU KFNTR+2 ¢INFUT BUFFER 

LEV EQU 3 SINTERR LEVEL 
ENDIF yINTERRUPTS 

Te ee 2 a 2 2 2 2 

3 

START: 
JMF INIT *INITIALIZATION 
JMF CONST sCONSOLE STATUS 
JMF CONIN gCONSOLE INPUT | 
JMF CONOUT sCONSOLE OUTFUT 
JMF LOUT sLIST OUTFUT 
JMF FUNCH 
JMF CONIN s5FOR READER 


fed oe ee x 


INITIALIZATION ROUTINES 


NIT$ MMVI Ar3 
OUT CSTAT  $RESET 
OUT LSTAT  #INTERFACE 
MVI Av15H 
OUT LSTAT 
; | 
IF INTRM 
MVI AySTOF #SET FOR INTERR. 
ENDIF 
; 
OUT CSTAT  sINTERFACE 
3 
3 COMFUTIME BOARD INITIALIZATION 
; 
XRA A SGET A ZERO 
OUT ACONT | 
OUT BCONT 
MVI A»y70H 
OUT ALATA 


ET LTTE TENCE At ANT TOL AC Te ATT SSSSAEEA AECTAA eC PanTS AsV nnneneehnehhnatanasnthteitamhthttr rer RASS 
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R20 3E77 MVI Ay?77H 

DR2E D3SCé OUT BATA 

NR30 3E14 MMVI Avyi4H 

NR32 D3CS OUT ACONT 

DR34 3E04 MVI Axv4 

DB36 L3C7 OUT BCONT 

5 OOOO CCK OKO CK OK aK 

IF INTRM 


FATCH RST LOCATION TO JUMF TO KEYED 


a> “Gp “GP 


QR38 FS NI gDISABLE INTERR 
DRS9 SECS MVI Av,OCSH 9JMF INSTR 
~~ TRSR 322800 STA BxXLEV sFATCH RST 
DRSE ES FUSH H 
QR3F 21 5B08 LXI Hy KEYBD ¢INTERR ENTRY 
DR42 222900 SHLD BxLEVti ¢ JUMP HERE 
DR4S 2106F4 LXI Hy BUFF sBUFFER ADDR 
DR48 2204F4 SHLD KPNTR gRESET POINTERS 
DB4k 2200F4 SHL I CFNTR 
DR4E 210000 LXI Hy»O #2 ZEROS 
DRS1 2202F 4 SHLD CCNT *ZERQO THE COUNTS 
NRS4 EL FOF H 
QBSS FR EI gRE-ENABLE INTERR 
ENDIF § INTERRUPTS 
SFPTPP RSET FRPP PREF ETT SSO ER ETE RRS R RR EE FD 
9 
§ INITIALIZE IORYTE 
? 
TES6 AF XRA A sRESET IOBYTE 
DRS7 320300 STA IOBYTE 
DRSA C9 RET 
SOOO OOOO OR OGIO IO IO GR KK xR 
IF INTRM 
¥ 
$ INTERRUPT ENTRY FOR KEYBOARD INPUT 
¥ 
QESE FS KEYRI? PUSH FSW 
DBSC DB1O IN CSTAT §CONSOLE STATUS 
DRSE E601 ANI CIMSK 
DR60 CA92DB AZ KEY2 gNOT REALY 
NR63 DBL IN CATA gGET DATA 
QB65 E67 ANI 7FH #MASK FARTITY 
y 
§ CHECK FOR “Sy “Q SCROLL CONTROL 
: # 
N67 FELS CFI CTRS 9S 
DBS9 C27F0R JNZ KEYS 9NO 
DB6C PRLO KEY4$ IN CSTAT §CHECK KEYROARD 
DBSE ESOL ANI CIMSK gREADY? 
NR70 CAé6CDR JZ KEY4 gLOOF UNTIL READY 
NB73 DBL IN CLATA sGET BYTE 
DB7S Ed6é7F ANI 7FH sSTRIF PARITY 
DB77 FELL CFI CTRQ 9 QP 
NE79 C2é6CUR JINZ KEY4 9NO 


DB7C C3920R JMF KEY2 


“ay 


QEZF 
REO 
DRS2 
DRESS 
TESS 
DRE? 
DERSA 
DeSI 
DESO 
NB9i 


DES? 
RSS 
TA94 


DROS 
DE98 


DEOR 
DESE 
DEAL 
TRA4 
DRA? 
RRAA 


TBAR 
QNEAE 
DBERO 


DRES 
DEBS 
URE? 
DERS 
DER? 
DEBRA 


DRBE 
CBBC 
TREF 
DECO 
UBC 
NRCS 


ES 
FEO4 
CAQSIE 
2A04F 4 
77 

23 
2204F4 
2103SF4 
34 

Ed 


Fi 
FE 
cy 


CHOBE 
C3910 


210000 
2202F 4 
2106F4 
2204F4 
2200F4 
Cc? 


3A0300 
E602 
C2CBRIE 


ES 
2A02F 4 
7C 


ZAQ0F 4 
7E 

El 
FEQS 
CACSDUR 
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sEMFTY BUFFER? 
9YES . 

sRUFFER POINTER 
gPUT IT THERE 
9INK FOINTER 
SAVE POINTER 
sGET COUNT 


_ INCREMENT IT 


sRESET FOINTERS 


FOINTERS TO START 


ZERO BOTH 


eRESET FNTRS 


CONSOLE INFUT REALLY 


gLIST 


INFUT BUFFER RATHER THAN KEYROARE 


9ROTH COUNTS 
#DIFFERENCE 
yNO INPUT 
¢COMFUTER FNTR 
gNEXT CHAR 


9“C? 


KEYS: FUSH H 
CFI CTRD 
JZ REYS 
LHLI KF NTR 
MOV MA 
INX H 
SHLI KENTR 
LXI Hse KONT 
INR M 

KEYS: FOF H 

7 

KEY23 FOF FSW 
ET 
RET 

9 

KEY63 CALL RSETF 
AMF KEYS 

? 

§ RESET BOTH 

RSETF3 LXI Hy0 
SHLI CONT 
LXI Hy BUFF 
SHLI KPNTR 
SHLI! CFNTR 
RET 
ENDIF 

ee 

9 

’ CHECK FOR 

g 

CONST? LIA IOBYTE 
ANI 2 
JNZ LISST 

3 

FCCC OCR OOO COOK KOK OK 
IF INTRM 

3 

§ CHECK 

9 
FUSH H 
LHLD CONT 
MOV AsH 
SUB L 
FOF H 
RZ 

3 
PUSH H 
LHL CFNTR 
MOV ArM 
FOF H 
CPI CTRC 
JZ QUIT 


MAKE CP/M THINK THERE 
SO SCROLLING WON‘T BE 


“Gp “ip “E> “aD 


gYES» QUIT 


IS NO INFUT 
ABORTED 
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seers mena ananecimestetoennteaanenemstnete CaCI CNL ICE 


DBCé AF XRA A $GET ZERO 
DBC? C9 RET 
SEPPRDPRPSTS TDR P PRD PPPEP RRR RRR ERE TE ERG 
; 
ELSE SNOT INTERRUFTS 
IN CSTAT  $GET STATUS 
ANI CIMSK 
RZ 3NOT READY 
ENDIF s INTERRUPTS 
; 
DBCS 3EFF QUIT?  MVI A» TRUE 
NECA C9 RET $INPFUT REALY 
; 
; LIST READY FOR CONSOLE 
; 
DECK DEi2 LISST! IN LSTAT 
DBCH E4604 ANI LIMSK 
NECF C8 RZ 3NOT REALY 
ENO 3EFF MVI Ay TRUE 
Nene C9 RET ;READY 
; 
$ CONSOLE INFUT 
; 
DBDS 3A0300 CONIN? LDA LOBYTE 
DBI6 E4602 ANI 2 
DBDS C206DC JNZ LIN $LIST INPUT 


Sp “Gp 


OO OOO OR ICICI OK AOKI OK I KK 
IF INTRM ¢ INTERRUPTS 


GET INFUT FROM KEYBOARD BUFFER 
INSTEAD OF FROM CONSOLE 


“a> “Gy “OP ‘> 


QEOB ES FUSH H 

NROC 2A02F4 CINS: LHLI! CONT §BOTH COUNTS 
DRBF 7C MOV AgH 

DREO 95 SUB L. 9 SAME? 

REL CADCKE JZ CINS *KEEFP TRYING 
DBE4 F3 ht sHOLI OFF 

DEES 2102F4 LXI HeCONT sCOMFUTER COUNT 
DRESS 34 INR M gINCREMENT IT 
NRE 2A0OF4 LHLD CFNTR sCOMPUTER FNTR 
DBEC 7E MOV Ay sGET BYTE 


RESET BOTH FOINTERS IF CARR RET FOUND 


“a> “Ge “IP 


DRED 23 INX H gRUMF POINTER 
QREE 2200F4 SHLIN CPNTR §SAVE IT 

DEF1 FEOD CFI CR sCARRIAGE RET? 
DBF3Z C203DC JNZ CINA ¥NO 

DBFS& 2A02F4 LHLTIt CONT 3GET BOTH COUNTS 
DRFY 7C MOV ArH 

DBFA 95 SUB L sRIFFERENCE 

DEFB C2012C JNZ CINS gNOT SAME 


RESET BOTH POINTERS TO ZERO 


ap “a> “ar 


Nnco}d 
NCOs 
hcoa 
ncon 
NCOF 
NC1i 


nci2 
Ocis 
i oe eg 
C18 


OnCik 
nein 
nCiF 
C22 
NC23 
DC25 


NC246 
nC29 
NC2R 


NC2e 
DnCS3O 
DC32 
nC3s 
NC3S 


CO9BOR 


Tibi? 
E401 
CAO6IIC 
DEi3 


3A0300 
E603 
B7 
E22E0C 


3A0300 
E640 
C21 B0nC 


Bi2 
E4602 
CAZENC 


FR ocr sar <a> 


a 
3 
» 
3 
a 
3 
C 


fT" <a> <r <a 


“a> “Oe “Gp 


IN; 


ONOUT: 


OUT? 


CALL 


RET 
ENDIF 


CONSOLE INPUT 


CONSOLE OUTFUT 


LIA 
ANI 


LIST OUTPUT 


LDA 


ANI 
JINZ 


IF 


NULLS FOR LIST DEVICE 


RSETF 
A»CR 
H 
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FRESTORE CR 


sREADY FOR MORE 


CSTAT  #CHECK STATUS 

CIMSK 

CIN2 

CUATA  $GET DATA 

7FH MASK PARITY 
3 INTRM 

FROM LIST 

LSTAT 

LIMSK 

LIN 

LOATA 

7FH 

IOBYTE $WHERE? 

3 

A 

LIST 

CSTAT  $CHECK STATUS 

COMSK 

CONW 

Asc 3GET BYTE 

CUATA  $SEND IT 

IOBYTE . 

40H SRIT 6 

CONW $CONSOLE OUT 

LSTAT  #$CHECK sTaTus 

LOMSK 

LIST 

AsC 3GET BYTE 

LUATA  $SEND IT 

LNULL * 0 
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sseccaaneanatmanainnainessnanueinnesesanenenereensaecantensatiteinsananet AAA ee AAAT NEAR LEN NEAT ELLEN ttCt tt tttAt CCC CCCOC OA CCC 


Lc3s8 
LIC3A 


IIic3k 
nese 
LC 3F 
lic42 
nC43 
«CAS 
LC 47 


2C48 
nc4? 
Lic 4B 
nc4c 
rc4n 
TC 4aF 
ncso 
ncs3 
ncss 
nCS8 
NCSB 
rcso 


FEOC 
CO 


CS 
O1L0A09 
CHZENC 
05 
C23SF IC 
C1 
Cc? 


Ch740C 
n3ii 
FEOn 
C25ENC 
Cc? 


Nei4 
E680 
CA69NC 
79 - 
D315 
Cc? 


“ar “Gr MED 


LSKIFS 


“Howe ar sa 


“Kosar -ar ~a> =e ay a> er 


“a> “tp “G> 


ANT 
CFI 
JINZ 
MMVI 
CALL 
CALL 
CALL 
JMP 


ENDIF 


CFI 
RNZ 


FREED 


$1 NULL 

§2 NULLS 
§3 NULLS 
§4 NULLS 


3 FORMFEED? 
»NO 


EMULATE FORMFEEL WITH 9 LINES 


FUSH 
LXI 
CALL 
NCR 
JNZ 
POF 
RET 


B 


Be SOOHT+LF 


LIST 
B 
LSKIF 
B 


FUNCH QUTFUT SENT TO MODEM 


MODEM INFUT 


UNCH: MOV Axl 
ANI 7FH 
ORA A 
RZ 
CRI LF 
RZ 
CALL MOUT 
CFI CK 
JZ MOUCR 
CALL MIN 
OUT CLATA 
RET 

SEND <CR> TO MODEM»? 

OBCR? CALL MIN 
OUT CHATA 
CFI CR 
JNZ MOUCR 
RET 

MODEM OUTFUT 

OUT? IN MSTAT 
ANI MOMSK 
SZ MOUT 
MOV A»yC 
OUT MIIATA 
RET 


sGET BYTE 
gNULL? 
sON’T SEND 
gSKIF 
§SENTD 
gWAIT FOR CR 


PMODEM INFUT 
s>SENT 


WAIT FOR ONE BACK 


§TO CONSOLE 


gKEEF TRYING 


sCHECK STATUS 


§GET BYTE 
*SEND IT 


LINEFEEL 


TO CONSOLE 
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nC74 B14 MIN: IN MSTAT *CHECK STATUS 
DC76 E640 ANT MIMSK 
nC78 CA74nc JZ MIN 
DC7B DB1IS IN MIATA *GET BYTE 
NC7D E6&7F ANI 7FH #MASK PARITY 
QC7F C9 RET 

3 
DC80 31322n DB ‘1-28-80 S$ VERSION 

3 
nc8s ENT 


symbol table 


00CS ACONT OOC4 ALATA 00OC7 BCONT OOCS BATA 
01600 BIOS F400 BUFFER F406 BUFF F402 CCNT 
0011 CATA 0001 CIMSK DENIC CINS ncos CIN4 
NCO1 CINS 0002 COMSK DENS CONIN PCi2 CONQUT 
DRAB CONST NCik CONW F400 CFNTR ooor CR | 
0010 CSTAT 0003 CTRC 0004 CTRD 0011 CTRA 
0013 CTRS FFFF DOUBLE 0000 FALSE O0OOC FFEED 
0nC38 FORM CBIS INIT FFFF INTRM (0003 TORYTE 
F403 KCNT DEO? KEY2 DE7F KEYS DR6C KEY4 
TES1 KEYS DROS KEYS DESEB KEYED | F404 KPNTR 
0013 LITA 0005 LEV 000A LF - 9001 LIMSK 
DCO6 LIN DECR LISST NC2E LIST 0000 LNULL 
0002 LOMSK NC26 LOUT DCSF LSKIF 0012 LSTAT 
0015 MDATA 0040 MINSK DC74 MIN NCSE MOLCR 
0080 MOMSK NC&é? MOUT 0036 MSIZE 0014 MSTAT 
4900 OFFSET DC48 PUNCH DBCB QUIT LEOR RSETF 
DROO START 0095 STOF FFFF TRUE NROO USER 


entry is read with an IN instruction. The byte is then placed into the key- 
board buffer and the buffer pointer and buffer count are both incremented. 
The interrupt flip-flop is enabled with an EI instruction, then the computer 
returns to its previous task. 

When the CPU needs another byte, it gets it from the keyboard buffer 
in memory, rather than from the keyboard itself. The instructions starting at 
subroutine CONIN perform this step. The separate buffer pointer and buffer 
count, maintained for the CPU, are both incremented. 

The interrupt-driven keyboard can be utilized with most of the CP/M 
systems programs. For example, if a BASIC interpreter has been loaded and 
a source program has been entered, then the source program can first be 
listed, then executed by typing the following two lines. 


LIST 
RUN 


The second command can be given immediately following the first, even 
though the first task has not been completed. The second command will not 
be displayed on the console, however, until the completion of the first task. 
Therefore, the operator must type carefully. 


nema neeeaeemem mmm eminem enenememmmmennane ns cnnns re ieee Ee ae EE 
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SCROLL CONTROL AND TASK ABORTION 


Data can appear (scroll) too rapidly on a high-speed video screen. With the 
usual CP/M arrangement, the user can type a Control-S to freeze the video 
display. Typing any other character will cause scrolling to resume. The 
interrupt-driven routine given in Listing 4.1 incorporates its own scroll con- 
trol. Typing a Control-S freezes the screen, just as with the usual CP/M 
setup. However, scrolling can only be resumed by typing a Control-Q. The 
two commands, Control-S and Control-Q, are treated distinctly; they are 
not placed into the input buffer, but are acted upon immediately. 

CP/M tasks are normally aborted by typing any keyboard character. On 
the other hand, a Control-C is required in Microsoft BASIC, and a Control-E 
is used by Xitan BASIC for aborting the current task. This protocol has been 
altered so that characters can be entered into the keyboard buffer during a 
scroll operation. Nevertheless, it may be desirable to abort a task. 

If no characters have been typed ahead, that is, if the computer is 
executing the latest command, then a Control-C command will abort the 
current operation. Alternatively, if there are characters waiting in the console- 
input buffer, then these must be flushed out by typing a Control-D. At this 
point, a Control-C can be typed to abort the task. This arrangement will 
work with most programs, including Microsoft BASIC and Tarbell BASIC. 
If you use Xitan BASIC, then you must change the abort command character 
in the interface routine from a Control-C to a Control-E. 

An additional alteration is necessary for the Word-Master text editor. 

First of all, Word-Master buffers the keyboard buffer using software routines. 
Consequently, a hardware-interrupt system is unnecessary. Secondly, Word- 
Master uses Control-C and Control-D for system commands. Control-C is 
used to display the next screen and Control-D is used to move the cursor to 
the next word. If you want to use hardware interrupts with Word-Master, 
you must change the Control-C and Control-D commands in either the inter- 
face routine or in Word-Master. 


DATA TRANSMISSION BY TELEPHONE 


The process of transmitting information between a peripheral and the com- 
puter may be simple or it may be complex. If the system console is wired 
into the computer, or if the computer itself is built into the console, then 
the integrity of the transmitted data is not likely to be much ofa problem. It 
may be, however, that the console is connected to the computer through a 
telephone line. The computer may be located across town or across the coun- 
try. In any case, connection through a telephone line complicates things. 

In a typical telephone arrangement, the data is sent from the console 
by modulating an acoustical carrier for transmission over the telephone line. 
The conversion is performed by an electronic device called a modem (the 
name is an abbreviation for MODulator-DEModulator). Two modems are 
required, one at each end of the telephone line. One converts the transmitted 
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signal to telephone frequencies, the other converts the signal back to the 
original data. 

The modem may also have an acoustical coupler. This allows a standard 
telephone headset to be pressed into two rubber-lined openings in the 
modem, making a direct connection between the modem and the telephone 
line unnecessary. 

There will usually be two data carrier signals at different frequencies. 
This allows simultaneous two-way, or full duplex, operation. The computer 
can transmit data to the console on one carrier while the console is trans- — 
mitting data to the computer on the other carrier. . 

A microcomputer can produce a more effective link between a console 
and a large main-frame computer, especially if a relatively slow modem is 
utilized. A program can be developed using the microcomputer’s editor, 
then the resulting file can be automatically transmitted to the larger com- 
puter. A subroutine that can be-used to link a microcomputer to a large 
computer is given in Listing 4.2. This routine can be readily incorporated 
into the system monitor introduced in Chapter 6. 


Listing 4.2 Connection to a larse computer 


CONNECT TO ANOTHER COMFUTER 
THROUGH FHONE MODEM 


“Bo 2b NED “GD ND 


(Z~-80 CODE) 

0014 STAT EQU 14H ISTATUS 
0015 DLATA EQU DSTAT+1 
0040 DIMSK EQU 40H PINFUT MASK 
0080 NOMSK EQU BOH 7OUT MASK 

? 
0004 CTRO EQU 4 >” Ds COPY 
v7AL TYFLG EQU STACK+1 sCOFY FLAG 

? 
SEBS AF NEC? XOR A §ZERO 
SBB4 32 S7A1l LO (TYFLG)*A SRESET COFY 
SBE? DB 14 DECIN: IN Ar(QSTAT) sREADY? 
SBB9 ES 40 AND DIMSK 
JBBB 28 13 JR ZeALTIN #NO 
SBBD 3A S7A1 Lo Avy (TYFLG) §sCOFPY FLAG 
SECO B7 OR A §TO MEMORY? 
SBC1 28 07 JR Z9DINS ¥#NO 
YBCS Cl SRF1 CALL DINFUT GET BYTE 
SEBC4& 77 Lo CHL) A #TO MEMORY 
SBC? 23 INC HL gFPOINTER 
SBC8 18 03 JR HEC? 
SBCA Cit SBF1 DINGS: CALL DINFUT #GET BYTE 
SBCD Ch S835 NEC2: CALL OUTT #T0O CONSOLE 
SBNO Ch 3827 ALTIN: CALL INSTAT #CONSOLE 
SBDS3 28 E2 JR Z»eDECIN ¢NOT REALY 
SBIS Cle S81A CALL INFUT2 CONSOLE 
UBDS FE 04 ALT23 CF CTRI! aT 
SBDA 28 1A JR Z90COFY ¢SET. FLAG 
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SBIC CD SRE ALTS CALL DECOUT ¢#TO DEC 
SBDF 18 Dé JR HECIN gDEC INFUT 


OUTPUT A BYTE TO DEC 


* 
? 
5 
a 
3 
sf 


SBE1 FS 1ECOUT: FUSH AF 
SRE2 CD SBEA CALL DORDY 
SBES Fil FOF AF 
SBE6 03 15 OUT CATA) 9A 
SBE8 18 CD JR DECIN eNEXT 
3 
§ DEC INFUT READY 
5 
‘SBEA DB 14 DOREY: IN Avy (USTAT? 
SREC E& 80 ANI DOMSK 
SBEE 28 Fi JR ZyTECOUT 
SRFO C9 RET 
3 
§ INPUT FROM DEC MODEM 
; 
SBF1 DB 15 QINFUT: IN Ay (CLILATA> 
SBF3 E& 7F ANT DEL #MASK FARITY 
SBFS C9 RET 


SET DEC COFY FLAG. START COPYING 
INTO MEMORY AT 100 HEX 


tJ te cy ae ae 


SBFS 21 0100 


cory: LoD HL» 100H 
SBF9 SE O1 me Avi 
SRFR 32 S7A1 Lt (TYFLG) »A 
SBFE 18 B?7 JR DECIN 
5 
END START 
PARITY CHECKING 


Parity checking provides a method of monitoring the integrity of data trans- 
mission. While there are several different schemes for digitally encoding the 
common characters, the ASCII method is frequently used for microcom- 
puters. The ASCII code, shown in Appendix A, requires only seven bits for 
each: character. Since each byte of data contains eight bits, there is one bit 
available for use as a check bit. 

Consider the 7-bit pattern for the ASCII characters 2 and 3. 


ASCII2 011 0010 
ASCIT3 011 0011 


The value of 2 is encoded with four logical zero bits and three logical 1 bits. 
The value of 3 is encoded with three logical zero bits and four logical 1 bits. 
A parity check can be obtained by including an additional bit on the left 
(high-order) end. 
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There are two common methods of generating the parity bit. One 
encoding method is called even parity. In this case, a leading zero bit is 
added if there are an even number of logical ones among the other seven 
bits. On the other hand, the parity bit would be a logical 1 if there are an 
odd number of logical ones among the other seven bits. With even parity 
coding, the ASCII characters 2 and 3 would look like this. 


2 1011 0010 
3 Q011 0011 


Now the 8-bit representation of both the 2 and the 3 contains an even num- 
ber of logical ones (and an even number of logical zeros). 

An alternate approach is called odd parity. In this case, the operation is 
simply the inverse of even parity. The logic of the parity bit is chosen so that 
the resulting bit pattern contains an odd number of logical ones. Either even 
or odd parity encoding will provide a check on the integrity of the dat 
transmission. 

Suppose that during transmission of the character 2, the rightmost bit 
became inverted. The console sent the even-parity bit pattern 


1011 0010 
but the computer received the bit pattern 
1011 0011 
A parity check, performed at the computer, would be able to detect the fact 


that there was an error. 
A typical console-input routine might look like this. 


CONIN: IN CMASK gCHECK STATUS 
ANI CIMNSK #MASK FOR INFUT 
JZ CONIN sLOOF UNTIL READY 
IN CDATA »GET THE DATA 
ANI 7FH .SREMOVE PARITY 
RET 


The next to the last instruction in this subroutine performs a logical AND 
with 7F hex. This step is used to remove the high-order bit of the byte since 
it is not needed for ASCII data. Instead of ignoring this eighth bit, we could | 
use it as a parity check. An input routine to perform a check for parity 
looks like the following list. 
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CONIN: IN CMASK §CHECK STATUS 
ANI CIMSK sMASK FOR INFUT 
JZ CONIN sLOOP UNTIL READY 
IN CDATA sGET THE DATA 
ORA rs) sSET PARITY FLAG 
JPO PERROR #PARITY ERROR 
ANI 7FH gREMOVE PARITY 
RET 


3 
§ PARITY-ERROR MESSAGE 


° 
PERROR? « + « 


This routine is essentially the same as the one given immediately before, but 
after the data register has been read by the computer, the parity of the byte 
is determined. , 

The ORA A instruction performs a logical OR of the accumulator with 
itself. A logical OR of any byte with itself will not change the byte. How- 
ever, it does affect the status flags in this case. After the OR operation, the 
parity flag will be set according to the parity of the accumulator. If the 
parity is found to be odd, then an error is present. The JPO instruction 
causes a jump to the parity-error routine in this case. However, if the parity 
is found to be even, then the byte in the accumulator does not contain a 
parity error. . 

Notice that a parity check will not detect an even number of bit errors 
in a byte. There may be two, four, or six errors, and the parity check will 
not detect an error. This is not likely to be a practical problem, however, 
since the likelihood of two errors is much less than the likelihood of single 
errors. 

ASCII computer terminals usually have the ability to automatically 
transmit an eighth parity bit with the data. Furthermore, there will typically 
be a user-selectable switch for choosing either even or odd parity. There may 
also be the additional choices of always resetting or always setting the parity 
bit. The input routine can check for odd parity if the JPO instruction is 
changed to a JPE instruction. 

There are much more sophisticated ‘methods of checking for transmis- 
sion errors. One of these is the checksum approach discussed in Chapter 9. 
With this method, the transmitted data are added together. At regular inter- 
vals, the sum, or its complement, is transmitted along with the data. When 
the data are decoded, the data are added up again and compared to the 
checksum. 

The Hamming error-correction code is even better than the checksum 
method. It not only detects errors, but can also correct them. In the end, 
however, it is wise to find out why errors occur, and to take the appropriate 
action to correct the problem. A dirty tape head, for example, can produce 
errors. Cleaning the head is better than relying on an error-correction 
scheme. 


CHAPTER FIVE 


Macros 


Sophisticated assemblers incorporate a macro processor. A macro is used to 
define a set of instructions which are associated with the macro name. Then 
whenever the macro name appears in the source program, the assembler 
substitutes the corresponding instructions. This is called a macro expansion. 

Suppose that we want to interchange the contents of two memory 
locations with the following instructions. 


LIA FIRST 9GET FIRST BYTE 
PUSH FSW § SAVE 

LIA SECOND §GET SECOND 

STA FIRST ePUT INTO FIRST 
FOP FSW *GET FIRST 

STA SECOND $FUT INTO SECOND 


This set of instructions can be defined in a macro called SWAP. 


SWAP MACKO sSWAP FIRST AND SECOND 
LDA FIRST sGET FIRST BYTE 
PUSH PSW SAVE 
LDA SECOND s¢GET SECOND 
STA FIRST sFUT INTO FIRST 
POP FSW §GET FIRST 
STA SECOND sPUT INTO SECOND 
END 


The macro definition is placed near the top of the assembler source program. 
The first line defines the macro name; the last line terminates the definition. 
The name SWAP can now be used like an operation code. it is placed in 
the source program whenever the corresponding instructions are needed. 
When the assembler encounters the name SWAP, it substitutes the desired 
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instructions. The final binary code generated by the assembler is the same as 
it would be if the instructions had originally been entered into the source 
program. 

Each time the macro name SWAP appears in the source program, the 
same set of instructions will be generated and the same two memory loca- 
tions will be interchanged. The SWAP macro becomes more versatile if the 
memory locations can be changed. If the names of the memory locations 
are placed on the first line of the macro definition, they become dummy 
variables. 


SWAP MACRO FIRST» SECOND 


LIA FIRST sGET 1ST BYTE 
PUSH PSW § SAVE 

LDA SECOND $GET 2ND 

STA FIRST sPUT INTO 1ST 
POP PSW *GET 1ST 

STA SECOND $FUT INTO 2ND 
ENDM 


The actual parameters in the macro call are substituted for the dummy 
parameters at assembly time. The macro call 


SWAP HIGH» LOW 


~ generates the assembly language instructions 


LDA HIGH *GET 1ST BYTE 
PUSH PSW §SAVE 

LDA LOW *GET 2ND 

STA HIGH gPUT INTO 1ST 
POP PSW #GET 1ST 

STA LOW sPUT INTO 2ND 


The statement 
—-SWwaAr LEFT» RIGHT 


will produce the instructions 


LDA LEFT GET IST BYTE 
PUSH FSW 3’ SAVE 

LDA RIGHT sGET 2NI 

STA LEFT sPUT INTO 1ST 
POP FSW §GET 1ST 

STA RIGHT sPUT INTO 2ND 


The structure of macros can be much more complicated than the above 
- examples. One macro can be nested inside another. 
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OUTER MACRO 
IF FAST 
INNER MACRO 


+ ¢ e 


ENDM 39 INNER 
ENDIF 3 9FAST 
ENDM 9 OUTER 


Conditional assembly directives can be used to create different versions. 
Comments in the macro definition which begin with a single semicolon are 
reproduced in the macro expansion along with the op codes. But if the com- 
ments are preceded by two consecutive semicolons, then they will appear 
only in the macro definition, not in the macro expansion. 


GENERATING THREE OUTPUT ROUTINES WITH ONE MACRO 


A subroutine can be used whenever a set of instructions is needed at several 
places in a program. But there are times when a similar but different group 
of instructions is needed. A subroutine cannot be used in this case. Consider 
the three 8080 output routines that follow. The first sends a byte to the 
console, the second sends a byte to the list device, and the third sends a byte 
to the phone modem. 


COT: IN CSTAT 
ANI COMSK 
JZ COT 
MOV Axl 
OUT CDATA 
RET 

9 

LOT: IN LSTAT 
ANI LOMSK 
JZ LOT 
MOV ArC 
OUT LIDATA 
RET 

3 

MOT: IN MSTAT 
ANI MOMSK 
JINZ MOT 
MOV ArC 
OUT MDATA 
RET 


The structure of these three routines is very similar. Each begins by 
reading the appropriate status register. Then a logical AND is performed to 
select the output-ready bit. Looping occurs until the peripheralis ready. The 
byte is moved from the C register into the accumulator and sent to the 
appropriate peripheral. Finally, a return instruction is executed. 
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These three routines are slightly different, hence they cannot be re- 
placed by a single subroutine. However, since they have similar structure 
they can be generated with a macro. The macro definition looks like this. 


OUTPUT HMACRO PSe?Z sOUTPUT ROUTINES 


P7S&OT: IN ?7SESTAT #CHECK STATUS 
ANI ?SR80OMSK $MASK FOR OUTPUT 
J&TZ ?S30T sNOT READY 
MOV ArC sGET BYTE 
OUT PSSDATA SSEND IT 
RET 
ENDM 


It would appear near the beginning of the source program. The macro name 
chosen is OUTPUT and the two dummy arguments are ?S and ?Z. Dummy 
arguments can have the same form as any other identifier. A question mark 
was chosen as the first character so that the dummy arguments would be 
easier to find in the macro definition. You must be careful not to use register 
names such as A, B, H, or L for dummy arguments if these register names 
also appear in the macro. 

Each of the three output routines is generated by a one-line macro call. 


QUTFUT CrZ §CONSOLE OUTPUT 
3 

OUTPUT Lez $LIST OUTPUT 
5 

OUTPUT MeNZ sMODEM OUTPUT 


Each line includes the appropriate parameters. At assembly time, the real 
arguments replace the dummy arguments of the macro. The ampersand 
character (&) is a concatenation operator. It separates a dummy argument 
from additional text. The macro processor substitutes the real parameter for 
the dummy argument, then joins it to the rest of the text. By this means the 
expression ?S&OT becomes LOT if the real argument is the letter L. 

Macro assemblers may give the user three options for the assembly 
listing: 


1. Show the macro call, the generated source line, and the resultant 
. hex code. 

2. Show the macro call and the hex code. 

3. Show only the macro call. 


If option 1 is chosen, then the above three macro calls to OUTPUT will pro- 
duce the following. 
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OUTPUT MACRO PS ?Z sOUTPUT ROUTINES 


?S20T? IN ?S&STAT SCHECK STATUS 
ANI ?S20OMSK sMASK FOR OUTPUT 
ARPZ ?S20T jNOT READY 
MOV Axl §GET BYTE 
OUT ?PS&RATA $SENT IT 
RET 
ENDM 
y 
OUTPUT Ce#Z *CONSOLE OUTPUT 
400040810 COTS IN CSTAT SCHECK STATUS 
HO0O2Z4+E4602 ANT COMSK sMASK FOR OQUTFUT 
40044040040 JZ COT SNOT READY 
4007479 MOV Ast §GET BYTE 
400840311 OuT CHATA SEND IT 
4Q0DATCY RET 
9 
OUTPUT LoZ SLIST GQUTPUT 
400B+0812 LOT? IN LSTAT sCHECK STATUS 
400D+E4602 ANI LOMSK sMASK FOR OUTFUT 
400F +CAOBSO JZ LOT sNOT READY 
4012479 MOV ArCl GET BYTE 
4OL34¢0313 OUT LDATA sSEND IT 
40154+C9 RET - 
9 ; 
OUTPUT MeNZ sMOREM OUTPUT 
4014640814 MOT: IN MSTAT SCHECK STATUS 
4019+4E490 ANI MOMSK sMASK FOR OUTFUT 
4AO1AtC2Z1640 JINZ MOT 3NOT READY 
401D+79 MOY A» *GET BYTE 
4O1E+0315 OUT MOATA sSENQ IT 
40204tC9 RET 


The first argument in the macro, 7S, is replaced by the actual argument. This 
is the letter C in the first call, the letter L in the second call, and the letter M 
in the third call. The second argument is used to select a JZ or JNZ instruc- 
tion for the third line of the macro expansion. 
Some assemblers automatically remove the ampersand symbol from the 
resultant assembly listing. Others leave the symbol in place. In this latter 
case, the first line of the first routine would look like this. 


CZ20T? IN C&STAT sCHECK STATUS 


But this is a matter of style. The actual machine code generated is the same 
in either case. 


GENERATING Z-80 INSTRUCTIONS WITH AN 8080 ASSEMBLER 


If you have a Z-80 CPU but an 8080 macro assembler, such as the Digital 
Research MAC, you can run all of the 8080 programs just as they are given 
in this book. You can also do the Z-80 programs by using macros to generate 
the Z-80 instructions. For some of the instructions, the regular Zilog mne- 
monic can be used. For other instructions a slightly different format is 
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necessary. Consider, for example, the Z-80 instruction that performs a two’s 
complement on the accumulator. The Zilog mnemonic for this operation is 
NEG. A Z-80 assembler converts this mnemonic into the two hex bytes 
ED 44. With an 8080 macro assembler you can use the same mnemonic. 
Define the macro 


NEG MACRO § TWO’S COMPLEMENT 
DB OEDHs 44H 
ENDM 


Then, the macro call 


NEG 


is placed in the source program when the Z-80 NEG instruction is needed. 
The 8080 macro assembler will insert the desired hex bytes ED 44 at this 
point. 

As another example, consider the Z-80 relative-jump instruction. This 
instruction can be implemented with a macro that uses the assembler’s pro- 
gram counter, a dollar sign. The macro definition looks like this. 


JR ADDR SRELATIVE JUMP 
DB 18H, ADDR-S$~1 
ENDM 


The dummy parameter ADDR is the destination address of the jump. The 
macro call 


JR ERROR 


will generate the correct Z-80 code. The first byte will be 18 hex. The 
second byte will be the required displacement for the jump. 

The Z-80 instruction, DJNZ, can be generated in a similar way. This 
instruction decrements the B register and jumps relative to the address of 
the argument if the zero flag is not set. The macro definition is 


DINZ MACRO ADDR 
DB LOHsADDR~S-1 


ENDM 


and the macro call looks like 


DJINZ LOOF 


_This approach will work with most macro assemblers. There may be a prob- 
lem, however, with the interpretation of the dollar sign. This symbol usually 
refers to the address of the beginning of the current instruction. But for 
some assemblers, it is interpreted as the address of the following instruction. 
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If your assembler uses the latter interpretation, you will have to change the 
macro accordingly. If in doubt, check the user manual. 

Some Z-80 mnemonics are not compatible with the macro format. ps! 
example, the Z-80 instruction 


PUSH IX 
cannot be generated with a macro called 
PUSH MACRO REG 


since PUSH is a regular 8080 mnemonic. One possibility is to name the 
macro PUSHIX instead. 


FUSHIX MACRO 
nB ODDH s OESH 
ENDM 


Similar problems occur with the commands POP IX, ADD IX,BC, SUB 
(IX+dis), and SET. A format that is different from the Z-80 mnemonic must 
be chosen in each of these cases. 

The Digital Research macro assembler has an added bonus. Frequently- 
used macros can be placed into a separate macro library and given the file 
extension of LIB. In fact, this assembler is supplied with a macro library 
called Z80.LIB that will generate all of the Z-80 instructions. The statement 


MACLIB Z8O 


~is placed near the beginning of the regular source program. The assembler 
will then look in the file Z80.LIB for the required macros. 


EMULATING Z-80 INSTRUCTIONS WITH AN 8080 CPU 


The Z-80 CPU can execute many powerful instructions that are not available 
to the 8080. Some of these useful instructions are difficult to implement on 
an 8080, while others are simply combinations of regular 8080 instructions. 
The NEG instruction is one of the easiest to implement. The macro defini- 
tion is 


NEG MACRO #8080 TWO’S COMPLEMENT 
CMA §91°S COMPLEMENT 
INR A §§2°S COMPLEMENT 
ENDM 


Now, whenever a two’s complement is needed, the macro call 


NEG 
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is placed into the program. The assembler generates the required 8080 
mnemonics 


CMA 
INR A 


Another useful Z-80 operation is the arithmetic shift. This operation 
shifts all bits of a register one position to the left. The high-order bit is 
moved into carry, that is, the carry flag is set to a 1 if bit 7 was originally a 
value of 1. The carry flag is reset to zero if bit 7 was zero. A value of zero is 
placed into the low-order bit (bit zero). 

The 8080 instruction ADD A, which adds the value in the accumulator 
to itself, performs the arithmetic shift left. But for the 8080, this is the only 
register which can perform the shift. The Z-80 has an additional instruction 
which allows this operation to be performed on any of the general-purpose, 
8-bit registers or on the memory byte referenced by HL, IX, or TY. 

The following macro will generate a set of 8080 instructions for the 
arithmetic shift left operation. 


SLA MACRO REG sSHIFT LEFT ARITH 
MOY AvREG §§GET BYTE 
ADD A §9SHIFT LEFT 
NOV REGrA 99FPUT BACK 
ENDM 


The byte is first moved to the accumulator. The next step is to add the 
accumulator to itself. This doubling operation performs the needed shift 
into carry. Then the result is returned to the original register. The value in 
register C can be doubled by inserting the macro call 


SLA Cc 


This macro must be used with caution, since the accumulator will be 
changed during use. But the byte originally in the accumulator cannot be 
saved with a PUSH PSW instruction. The problem is that the subsequent 
POP PSW command will overlay the flag register, so that the carry result of 
the shift will be lost. One solution is to save the accumulator in memory. 


SLA MACRO REG sSHIFT LEFT ARITH 
STA SAVE g3SAVE A 
MOV AVREG §3GET BYTE 
Abn A 9 SHIFT LEFT 
MOV REG 9A §$PUT BACK 
LDA SAVE yPRESTORE A 


ENDM 


MACROS 177 


THE REPEAT MACROS 


There are times when several lines of identical or nearly identical lines of 
code are needed. Three repeat macros, REPT, IRP, and IRPC are provided 
for this purpose. The repeat macros differ from the regular macros in that 
they are placed directly into the source program where they are needed. The 
macro definition is the macro call. In the simplest form, an instruction or 
group of instructions can be replicated. The expression 


REPT 4 
RAR 
ENDM 


will generate the four lines 


RAR 
RAR 
RAR 
RAR 


By using the SET directive, this operation can become more versatile. The 
SET instruction is like an EQU except that the value can be redefined. 
The lines 


ADDR SET 8000H 
REPT 4 

ADR SET ABIR+3 
Tw ADR 
ENDM 


will generate the code corresponding to 


nw 8003H 
DW 8006H 
DW B009H 
DW 800CH 


Such a series could refer to jump vectors that are spaced three bytes apart. 

The repeat macro, combined with the conditional-assembly directive, 
can generate the required number of nulls after a carriage-return, line-feed 
pair. This will give the printer time to return to the left margin. Some 
printers need no nulls, whereas others may need as many as six or seven. The 
source code could be 


OUTPUT TO LIST DEVICE 


OUT: IN LSTAT 
ANI LOMSK 
JZ LOUT 
MOV ArC S$GET DATA. 


OUT LBATA $SEND BYTE 
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* Sa 


IF NULLS > 0 

ANI 7FH SREMOVE FARITY 
CPI CR SCARRIAGE RETURN? 
RNZ 3NO 

MVI C0 sGET A NULL 


a> 


REPT NULLS sHOW MANY? 
CALL LOUT sSEND NULL 


ENDM sREPEAT MACRO 
ENDIF. gNULLS 

$ 
RET 


The first part is a typical output subroutine. A call is made with the byte in 
register C. When the output device is ready, the byte is moved from the C 
register to the accumulator. It is then sent to the printer. If no nulls are 
required, then the passage from 


IF NULLS > 0 
to 
ENDIF 


is not assembled. On the other hand, if nulls are required, then this passage 
is assembled. If four nulls are needed, then the assembler will generate four 
lines of | 


CALL LOUT §SEND NULL 


The list output routine calls itself to produce the required nulls. The identi- 
fier called NULLS must be previously set to the necessary number of nulls. 

There are two other repeat macros called IRP and IRPC. A set of one- 
character message routines can be generated by using the indefinite repeat 
macro IRPC. This example will introduce something called a programming 
trick. Some people think that it is a horrible example of programming. 
Others think it is very clever. Its purpose is to save two bytes of instruction 
each time it is used. In addition, less branching is required. 

Suppose that we need five different message routines that each produce 
a single character. The instructions might look like 


CHARC: MMVI Ar ’C’ 
JMP OUTT 

CHARM: MMVI Ay “M’ 
MP OUTT 
CHARRS WMVI- As “R’ 
JMP OUTT 

CHAR?: MMVI A PS 
JMF OUTT 

CHARS? MMVI Ar’ S$’ 
JMP OUTT 


¢ e 6 


OUTT? output routine> 
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If the B and C registers are not in use, we can shorten the above passage by 
replacing each line containing the instruction JMP OUTT with a line of DB1. 


CHARC? MMVI Av ‘’C’ 
DB 1 
CHARMS MMVI As “4° 
. DB 1 
CHARR: MMVI Ar’R’ 
DE 1 
CHART: MVI Ay’ ?%° 
DR 1 
CHARS! MVI Ay “S$? 


7 z 
OUTT: ¢ 6 8 


Let’s see how this works. Suppose that a branch is made to the label 
CHARC, The accumulator is loaded with an ASCII letter C. The next byte, 
a DB 1, looks like the start of an LXI B instruction. The following two 
bytes, corresponding to the MVI A,'M’ instruction, will be interpreted as the 
argument for the LXI instruction. That is, they will be considered as data. 
The same will hold for the other occurrences of DB 1. By this means, we 
have effectively shortened the code. We no longer need the JMP statements. 
Caution: a disassembler is not likely to interpret this passage correctly. It 
looks like there are labels pointing into the middle of the LXI instructions. 
Notice that the second version has subroutine OUTT positioned directly 
under the CHAR$ routine, so that no JMP instruction is needed at this 
point. 
The second version can be easily generated with the IRPC macro. Only 
five lines are needed in the source program. 


IRFC Xo CMPRPS 


DB 1 sFAKE LXI B 
CHAREX: HVI Av ’&x’ 
ENDM 


The five different message routines are all generated with this single macro. 
One replication is made for each character of the second argument to IRPC. 


PRINTING STRINGS WITH MACROS 


Suppose that we want to send messages to the console from various points 
of a program. We could write a subroutine called SENDM for this purpose. 


SENDM: LDAX D gGET CHAR 
ORA A §ZEROP? 
RZ §YES 
INX D sPOINTER 
MOV CrA 


CALL OUTT SENT 
JMP SENDM §NEXT 
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: The address of the message is loaded into the DE register and subroutine 
SENDM is called. 


LXI De MESS1 
CALL SENDM 


- Subroutine SENDM prints a message by sending each character to the output 
subroutine OUTT. When a binary zero, used to indicate the end of the mes- 
sage, is found, SENDM returns to the calling program. 

We can simplify the sending of messages by using a macro called PRINT. 
At each point we write 


PRINT <CHECKSUM ERROR? 
® @ ¢ 
PRINT SEND OF FILE> 


* ¢ e 


PRINT <OUTPUT TO LIST?> 


The macro called PRINT will generate the message given in the argument. 
_ The message is enclosed in angle brackets because the blanks are part of the 
argument. . 

If subroutine SENDM were placed into the macro body, then one copy 
of SENDM would be inserted for each occurrence of the PRINT statement. 
But we don’t need more than one copy of SENDM. On the other hand, if 
we don’t include SENDM in the macro, there may not be any copies at all. 
What we need is a mechanism for inserting one, and only one, copy of 
SENDM regardless of how many times we give the PRINT command. 

The solution is to write a double macro—one nested inside the other. 
Both macros will be given the same name. Subroutine SENDM will be part 
of the outer macro which will be expanded only once. The layout looks 
like this. 


PRINT MACRO <messade> jOUTER MACRO 


Cdefine SENDMI 
PRINT MACRO <messade> §INNER MACRO 
send message] 
-ENDM sINNER MACRO 
on 


ENDM SOUTER MACRO 


The source program in Listing 5.1 demonstrates this technique. The outer 
macro PRINT has the argument ?TEXT, used for the first call to the macro. 
Subroutine SENDM is generated at this time. Additional macro calls to 
PRINT utilize the inner macro which has the argument ?TEXT2. Subrou- 
tine SENDM is not generated on these subsequent calls. 


Listing S.1. 


a 


F 

FRINT MACRO 
LOCAL 

3 


JMF 


Ch ap scp ~ap ~ce «> 
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Source listing for &@ macro 
demonstration Frograms 


PTEXT 
AROUNT! 


AROUND sSENDM 


SUBROUTINE TO SEND A STRING TO 
THE CONSOLE. BINARY ZERO AT STRING END. 


fivE IS STRING FOINTER. 
ENDM? LIIWAX i §GET CHAR 
ORA A 9 ZERO? 
RZ §YES 
INX D sFOINTER 
MOV ~CrA 
CALL OUTT gSENT 
JMF SENIIM §NEXT 
9 
AROUNT? 
9 
§ REDEFINE THE MACRO 
; 
FRINT NACKO PTEXT2 
LOCAL MESG» CONT 
3 
FUSH fy eSAVE Ive 
LXI tieMESG ¢FOINT 
CALL SENIM 
FOF ti §RESTORE 
JMP CONT gSKIF MESSAGE 
? 
MESG$ 
DE CReLFe ‘&?TEXT2/ 90 
5 
CONT? ENIM SINNER MACRO 
FRINT LPTEXTS 
ENDM SOUTER MACKO 
3 
CSTAT EQU 10H sCONSOLE STATUS 
CUATA EQU CSTAT+1 S$CONSOLE DATA 
CK EQU 13 sCARRIAGE RETURN 
LF EQU 10 gLINE FEED 
3 
ORG 100H 
START: 
FRINT CHECKSUM ERROR. > 
3 
PRINT SEND OF FILE.= 
3 
FRINT <OUTFUT TO LIST?> 
JMF 0 sRETURN TO CF/M 


a> “Ie “aD 


SENI) CHARACTER IN C TO THE CONSOLE 
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OUTT: IN CSTAT 
ANI 2 
JZ QUT T 
MOV Arl 
OUT CLATA 
RET 

3 
END 


Subroutine SENDM is coded into the main flow of the program, that 
is, it is an inline routine. It is therefore necessary to jump around SENDM. 
Additionally, there must be a branch around each of the messages, since they 
too are coded inline. Labels for the required branches are uniquely gener- 
ated in the macro by declaring the corresponding labels as LOCAL. The 
resulting assembly listing is given in Listing 5.2. The assembler places plus 
symbols between the address and the generated code of the assembly listing 
- to designate those lines that were generated by macros. Thus, lines that 
contain plus symbols were not present in the original source listing. 


Listind 5.2. Assembly listing for 3&2 macro 
demonstration frrodram. 


9 
FRINT MACRO ?PTEXT 

LOCAL AROUND 
3 

JMF AROUND #SENIIM 
3 
§ SUBROUTINE TO SEND A STRING TO 
9 THE CONSOLE. RINARY ZERO AT STRING ENT. 
’ DeE IS STRING POINTER. 
9 
ss) 


ENDM? LIIAX Is *GET CHAR 


ORA A sZERO? 
RZ 9YES 
INX ft sPOINTER 
MOV CrA 
CALL OUTT ¥SENT 
JMP SENIIM gNEXT 

9 

AROUND: 

3 

§ REDEFINE THE MACRO 

3 

PRINT MACRO PTEXT2 
LOCAL MESG » CONT 

3 
FUSH ih gSAVE Dre 
LXI DsMESG ¢POINT 
CALL SENDIM 
FOF I gRESTORE 
JMP CONT gSKIF MESSAGE 


DB | CReoLFy’&?TEXT2° 90 
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CONT! — ENDM SINNER MACRO 


PRINT <PTEXT? 
ENDM sOUTER MACRO 
? 
0010 = CSTAT EQU 10H §CONSOLE STATUS 
0011 = CLATA EQu CSTAT+1 #sCONSOLE DATA 
ooor = CR EQuU 13 sCARRIAGE RETURN 
000A = LF EQU 10 LINE FEET 
3 
0100 ORG 10Q0H 
START: 
FRINT “CHECKSUM ERROR, > 
OLOOTCSOEO1 JMF ??7OO001 #SENDM 
OLO3+1A SENIIMS LIVAX 0 §GET CHAR 
01044587 ORA A ¥ZERO? 
O10S+C8 RZ gYES 
0106413 INX D sPOINTER 
O1074+4F MOV CvA 
O1084+CN6501 CALL OUTT §SENT 
O1LOBt+C 30301 JMF SENTIM yNEXT 
OLOE+DS FUSH i SSAVE DvE 
O10OF 4111901 LXI Iie ??O0002 sPOINT 
0112+C00301 CALL SENDIM 
0115t01 FOF n #RESTORE 
01164C032B01 JMF ??0003 FSKIP MESSAGE 
O119+00N0A434845 DB CReLF» “CHECKSUM ERROR.’ +0 
§ 
PRINT END OF FILE. > 
O12B+05 FUSH B §SAVE [lvE 
01204113601 LXI Tis??Q0004 SPOINT 
O12F+C00301 CALL SEND 
O132+01 FOF Q #RESTORE 
01334034501 JMF FPOQOOS sSKIF MESSAGE 
O1SS6+000A454E 44 DR CReLFs “END OF FILE.‘ +0 
3 
PRINT “OUTPUT TO LIST?= 
0145405 PUSH n SSAVE DvE 
01464115001 LXI De??Q0006 sFOINT 
0149+CD03Z01 CALL SENDM 
O14C4+Di FOP Ih gRESTORE 
O1404C36201 JMP ?7O0007 $SKIF MESSAGE 
OLSO+FOD0A4SF S554 DB CReoLF» “OUTFUT TO LIST?’ 20 
0162 C30000 JMF 0 gRETURN TO CP/M 
9 
§ SENT CHARACTER IN C TO THE CONSOLE 
? 
0165 DBR10 OUTT: IN CSTAT 
0167 E602 ANI 2 
0169 CA6501 JZ OUTT 
016C 79 MOV Axl 
0160 D311 OUT CLOATA 
O16F C9 RET 
? 
0170 END 
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If you are familiar with the operation of your assembler, type up the 
demonstration program and try it out. Branch to the beginning and three 
messages will appear at the console. 


Checksum error 
End of file 
Qutrut to list? 


Assembler operation will be considered in the next chapter. 

By constructing increasingly complicated macros, it is possible to 
develop some of the structure that is characteristic of higher-level languages 
‘such as Pascal. The common loop constructions 


REPEAT 


® e e 


UNTIL Yeondition true> 


LOOP 


EXITIF <condition true> 
e e . 2 
ENDLOOP 


can be realized with macros called REPEAT, UNTIL, and so on. The argu- 
ments to UNTIL and EXITIF will consist of three terms. The first and third 
will be numeric values. The middle term will represent a logical operation 
such as EQUALS or LESS THAN. The spelling of the logical operators in 
_ this case will have to be unusual, since the normal spellings 


EQ 
LT 
GE 


are already utilized by the macro assembler. Macros for all of the common 
structures are available commercially. Also, source programs for structured 
~-macros of this type may be given in the instruction manual for your macro 
assembler. 


CHAPTER SIX | 
Development of 
a System Monitor 


The best way to learn assembly language programming is to actually do it. 
Consequently, in this chapter you will develop a small but very powerful 
utility program called a monitor. There are many useful things that can be 
done with the monitor. There is a command to examine memory and another 
to change it. Other commands deal with memory blocks. These allow you to 
move a block from one location to another. Some of the features will dupli- 
cate those found in other programs, but other features, such as a search 
routine and a memory test routine, will be unique. 

You will not program the entire monitor at one time. Instead, you will 
start with just the bare essentials. You will check the monitor after each 
major change to ensure that the new features have been added correctly. 
With this so-called top-down method, any error that develops is likely to be 
found in the most recently added instructions. As new features are incorpo- 
rated, the monitor will increase in size until it reaches 1K bytes. This is a 
size that can be easily programmed into a single ROM. The monitor will 
then be immediately available as soon as the computer is turned on. 

An editor and an assembler are required for the development of the 
monitor. In addition, a debugger will be helpful if you have problems along 
the way. Each phase of the development will require the same sequence of 
steps. 


1. Generate an assembly language source file with the editor. 

2. Assemble the source program to produce an object file. 

3. Compare the hex code from your assembly listing to the listing 
given in this chapter. 

4, Load the object program into memory. 

5. Branch to the monitor and try it out. 
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The assembly listings given in this chapter are written with 8080 mne- 
monics. You can use an 8080 assembler for these programs whether you 
have an 8080 or a Z-80 CPU. The resulting code will run on both an 8080 
and a Z-80 CPU. If you have only a Z-80 assembler, you will have to change 
the mnemonics. The cross-reference between the 8080 and Z-80 mnemonics, 
given in Appendix G, can be used to find the corresponding instructions. 
Alternately, you can define the 8080 mnemonics as macros. 


PROGRAM DEVELOPMENT DETAILS 


This section describes the details of program development. Skip to the next 
section if you are familiar with the operation of your editor and assembler. 
An editor is needed to create and alter the assembly language source file. If 
you have CP/M, you will have an editor called ED. Other editors, such as 
ED-80, EDIT80, and Word-Master, are separately available. 

The session begins by giving the name of the editor and the name of the 
source program. The following discussion assumes that you have CP/M. If 
you have some other operating system, the approach will be similar, but the 
details may differ. Put the CP/M system diskette in drive A and a working 
diskette in drive B if you have more than one drive. Go to drive B with the 
command 


ASB? 
The response will be 
_B> 


Type the name of the editor followed by the name of the monitor source, 
program. The command line might look like this. 


BrAsED MONL.ASM 


for the first version. The digit 1 in the filename refers to the version number. 
The file type is ASM for the Digital Research assemblers ASM and MAC. 
The file type should be chosen as MAC, however, if the Microsoft assembler 
is used. 

As you type the source program, be careful to include only the instruc- 
tions and the comments shown in Listing 6.1A. Do not type the resulting 
hex code that is also given at the beginning of each line. For example, the 
line that defines the parameter TOP, on the first page of the listing, should 
be typed as 


TOP EQU 24 *MEMORY TOP, K BYTES 
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rather than as: 


0018 = TOP EQU 24 SMEMORY TOPs K BYTES 


Type a Control-I or tab to automatically generate the blank spaces between 
symbols. 
Most of the assembly language symbols have five or fewer characters. 

This is acceptable to many assemblers. However, if your assembler only 
allows names to have a maximum of five characters, then several symbols 
will have to be shortened. The TITLE directive, on the first line, is another 
potential problem. The CP/M version is shown. The apostrophes should be 
removed if the Microsoft assembler is utilized. If the TITLE directive is not. 
available on your assembler, place a semicolon at the beginning of this first 
line to convert it to a comment. 


VERSION 1: THE INPUT AND OUTPUT ROUTINES 


Refer to Listing 6.1A. This version will contain only the input and output 
routines. Generate an assembler source file with the system editor. The 
following variables will have to be tailored to your particular system. : 


TOP (top of usable memory, decimal K) 
HOME (where to return when done) 
CSTAT (console input status address) 
CDATA (console input data address) 


CSTATO (console output status address) 
CDATAO (console output data address) 
INMSK (input-ready mask) 

OMSK (output-ready mask) 

BACKUP (console backspace character) 


Normally, CSTATO will be the same as CSTAT, and CDATAO will be the 
same as CDATA. But if your console input address is different from your 
console output address, then each can be separately defined. Furthermore, 
the address of CDATA will typically have a value one larger or smaller than 
that of CSTAT. 
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Listing 6,.1A, 


0018 
2800 


3800 


0000 


0031 
37A0 
0010 
0011 
0010 
0011 
0001 
0002 


w7AO0 
v7AS 
B7AS 
S7AG 


0008 
0009 
0011 
0013 
0018 
0008 
007F 


OO1B 


OOF7 
-000n 
000A 
OOD 
oon3 
00cg 


3800 
9803 


3806 
3809 
380C 
JBOE 
3810 
3812 
3815 


Hol 


HHH H  H OH OW u 


Hou UW fo On HO POH OR UO 


C34AS8 
C35358 


CD1658 
CA0658 
DB141 
E&7F 
FEIS 
CA0000 
C9? 


TITLE 


@> Ge “a 


TOF EQU 
ORGIN EQU 
3 
ORG ORGIN 
3 
5 
HOME EQU 
3 HOME EQU 
VERS EQU 
STACK EQU 
CSTAT EQU 
CLATA EQU 
CSTATO EQU 
CIATAO EQU 
INMSK EQU 
OMSK EQU 
5 
FORTN EQU 
I BUFF EQU 
IRBUFC EQU 
IBUFF ERQU 
9 
CTRH EQU 
TAB EQU 
CTRQ EQU 
CTRS EQU 
CTRX EQU 
BACKUP EQU 
NEL EQU 
ESC EQU 
AF'OS EQU 
CR EQU 
LF EQU 
INC EQU 
OUTC EQU 
RETC EQU 
9 
START: 
JMP 
RESTRT$ JMF 
y 
§ CONSOLE INPUT 
3 
INPUTT? CALL 
JZ 
INFUT2: IN 
ANI 
CFI 
JZ 
RET 


a> ‘ar “Ge 


‘8080 sustem 


The besinning of a system monitor. 


monitors ver 1’ 


(put today’s date here) 


24 yMEMORY TOF» 
(TOP -2)%1024 


0 $ABORT (VER 1-2) 
ORGIN 7ABORT ADDRESS 
— §VERSION NUMBER 
ORGIN-60H 

10H §CONSOLE STATUS 
CSTAT+1 SCONSOLE TIATA 
CSTAT sCON OUT STATUS 
CSTATO+1 sOQUT DATA 

1 ¥INFUT MASK 

2 sOUTFUT MASK 
STACK 3 RYTES 1/0 
STACK+3 # BUFFER POINTER 
IBUFF+2 * BUFFER COUNT 
IBUFF+3 ¢INFUT BUFFER 

8 9H BACKSPACE 

9 5 

17 a” Q 

19 3 

24 §~X» ABORT 

CTRH sBACKUP CHAR 
127 sRUBOUT 

27 pESCAPE 
(39-00%) AND OFFH 

13 SCARRIAGE RET 
10 gLINE FEED 

ODBH ¢IN OF CODE 
OD3H sOUT OF CODE 
OC9H sRET OF CODE 
COLD sCOLD START 
WARM sWARM START 
ROUTINE 

INSTAT #CHECK STATUS 
INFUTT §NOT REALIY Xxx 
CUATA *GET BYTE 

DEL. 

CTRX SABORT? 

HOME 9YES 


GET CONSOLE-INFUT STATUS 


K BYTES 
s;PROGRAM START 


3816 
3818 
381A 


wO1B 
981C 
o81F 
3822 
9825 
3827 


582A 
veer 
S82F 
S832 


9835 
3837 
B39 
SB3C 
o83ri 
S83F 


9840 
3842 
53847 
JB4P? 


JvB4A 
3840 
9850 


wBSS 
NBS6 
9857 
385A 
S85 
3860 
5862 


9865 
3867 


' 586A 


986C 


JB6F 
3371 


9874 


LR10 
E601 
cy 


FS 
Cn1658 
CA35S58 
Cpuocss 
FE13 
C21C058 


ChO658 
FEI 

C22A58 
C31C58 


DBO 
E602 
CAICS8 
Fi 
0311 
Cy 


ODOA 
205665 
3100 
00 


31A0S7 
114058 
CHE258 


215358 
ES 
CUBé6S58 
C7758 
CECCS8 
FE44 
CAS358 


FE4S 
CAS3S8 


FE47 
CAS3S8 


FE4C 
CAS358 
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INSTAT?: IN CSTAT 
ANT INMSK 
RET 


“Sb NED “OD 


CONSOLE OUTFUT ROUTINE 


OUTT: FUSH POW 
DUT23 CALL INSTAT #sINFUT? 


Cy xa sar <> 


JZ OUT4 NO XXX 
CALL INFUT2 §GET INFUT 
CFI CTRS sFREEZE? 
JNZ OUT? 9NO 


FREEZE QUTFUT UNTIL “@Q OR “x 


UTS¢ CALL INFUTT SINFUT? 


CPI CTRQ sRESUME? 
JNZ OUTS 5NO 
JMF OUT? 

3 

OUT4: IN CSTATGQ CHECK STATUS 
ANI OMSK 
JZ OUT? SNOT REATY Xx 
FOF PSW 
OuT CHATAOG sSEND DATA 
RET 

5 

SIGNON? DE CReLF 
De ‘ Ver *° 
DW VERS 
eB 0 

5 

6 CONTINUATION OF COLD START 

3 

COLIN LXI SF e STACK 


ae 


“a> 


“tb 


ap 


Sp 


LXI DeSIGNON MESSAGE 
CALL SENINM eSEND IT 


WARM-START ENTRY 


ARM: LXI HsWARM #RETURN HERE 
FUSH H 
CALL CRLF sNEW LINE 


CALL INPLN sCONSOLE LINE 
CALL GETCH sGET CHAR 


CFI “Ti? § DUMF 

JZ WARM s(VER 1) 

JZ DUMF sHEX/ASCII (2) 
CFI i a sCALL 

JZ WARM 9(VER 1-2) 

JZ CALLS s SUBROUTINE (3) 
CFI °G’ *GO 

JZ WARM g(VER 1-2) 

JZ GO SOMEWHERE (3) 
CFI cL sLOAL 

JZ WARM §(VER 1-3) 

JZ LOAL INTO MEMORY (4) 


IMP WARM §TRY AGAIN 
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5877 


vB879 
7870 
IB7F 
3882 
5884 
3887 
3889 
988Cc 
888E 
5871 
9893 
5896 
3898 
JB99 
589R 
8B9C 
SB9F 
J8A0 
SBA 
wBAZ 
SBAS 


3BAS 
uBAA 
J8AD 
SBAF 


V8B2 
BBS 


USES 
5888 
58BB 
J8SRo 


y8CO 
w8C1 
J8C2 
98CS 
58C6 
98C7 
sBC9 


SEE 
CD1IBSS8 
210657 
22357 
0E00 
CLO658 
FE20 
DAABSE 
FE7F 
cacoss 
FESB 
LA9858 
E6SF 
77 
3E20 
Eg 
CAB458 
7E 

23 

oc 
CD1iBSS 
C38458 


FEOS 
CACOSS 
FEOD 
C28458 


79 
32A5957 


SEOD 
CDisBSS 
SEOA 
C31B58 


79 

RB? 
CA8458 
2B 

on 
SEO8 
C3A258 


ped “tp “GP “GP tGD Np WE 


INFUT A LINE FROM CONSOLE AND FUT IT 
INTO THE BUFFER. CARRIAGE RETURN ENDS 
THE LINE. RUBOUT OR “H CORRECTS LAST 
LAST ENTRY. CONTROL-~X RESTARTS LINE. 
OTHER CONTROL CHARACTERS ARE IGNORED 


NFLN3 MMVI Ag! ot oP ROME T 
CALL OUTT 
INFL2: LXI He I BUFF Ss BUFFER ADDR 
SHLD IBRUFF sSAVE FOINTER 
MVI CxO 3 COUNT 
INPLIS CALL INFUTT $CONSOLE CHAR 
CFI a ae § CONTROL? 
JC INPLC ¢YES 
CFI NEL SDELETE 
JZ INF LE sYES 
CFI eae | SUFFER CASE? 
JC INFL3 SYES 
ANI oFH sMAKE UPPER 
INPL3$ MOV MeA INTO BUFFER 
MVI Av 32 §BUFFER SIZE 
CMP C sFULL? 
JZ INFLI 9YES» LOOF 
MOV Ash §GET CHAR 
INX H ¢INCK FOINTER 
INK C sAND COUNT 
INFLE$ CALL OUTT gSHOW CHAR 
JMF INFLI §NEXT CHAR 


S> MID > 


CD ee sae os 


FROCESS CONTROL CHARACTER 


NFLC? CFI CTRH 3H? 
JZ INPLE 9YES 
CFI CR gRE TURN? 
JNZ INFLI gNOvy IGNORE 


END OF INPUT LINE 


MOV ArC ¥COUNT 
STA IBUFC § SAVE 


CARRIAGE-RETURNs LINE-FEED ROUTINE 


RLF MVI AsCR 
CALL OUTT sSEND CR 
MVI Ag LF 
JMF OUTT gSEND LF 


DELETE PRIOR CHARACTER IF ANY 


NPLB3 MOV AsC gCHAR COUNT 
ORA A § ZERO? 
JZ INFLI sYES 
ncx H §BACK FOINTER 
DCR C SAND COUNT 
MMVI Avs BACKUF sCHARACTER 
JMF INPLE ySEND 


GET A CHARACTER FROM CONSOLE BUFFER 
SET CARRY IF EMFTY 


~BCC ES 
Y8CI 2AAZS7 
YBDO SAASS7 
3803 04601 
8805 DAEOSS 
S808 32A557 
~8NR 7E 
88DC 23 
S80D 22A357 
Y8EO Ei 
38E1 C9 


w8E2 1A 
wS8E3 7 
J8E4 C8 
J8ES ChIBSS 
Y8E8 13 
SSE? C3E258 


VBEC 


a 


5 
GETCH: 


GETC4$ 


Cf] «a> <> ~w> «> 


ENDM 3 


“a> 
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_SEND ASCIT 
IS FOUND. 


ENT! 


sSAVE REGS 

GET FOINTER 
sAND COUNT 

sTECK WITH CARRY 
¢NO MORE CHAR 
sSAVE NEW COUNT 
*>GET CHARACTER 
¢INCK FOINTER 
sAND SAVE 
SRESTORE REGS 


MESSAGE UNTIL BINARY ZERO 
POINTER IS DteE 


I 
A 


OUTT 
Qn 
SENIM 


sGET BYTE 
sZERO?T 
sYES» DONE 
sSEND IT 
sFPOINTER 
9NEXT 


if you don’t know the addresses of the console status and data registers 
and you are using the CP/M operating system, there is another approach you 
can take. You can use the I/O routines in the CP/M BIOS. The disadvantage 
of this approach is that CP/M must always be in place whenever the monitor 
is used. The BIOS entry address is given at memory address 1. The console 
status, input and output addresses are obtained by adding, respectively, 3, 6, 
and 9 to this address. The following I/O routines in Listing 6.1B can be sub- 
stituted for the subroutines in Listing 6.1A starting with the label INPUTT 
. and ending with the label OUT2. If this version is utilized, the addresses in 
the following sections will not agree with your assembly listings. 


Listing 6.1B. Alternate I/O routines using CF/M BIOS. 


5806 E5 
9807 DS 
2808 CS 
9809 211558 
S80C ES 
380D 2A0100 
9810 110600 
9813 19 
59814 E9 
3815 Ci 
9816 Di 
9817 E1 
“818 FEIS 
381A CA00S8 
9810 C9 


§ CONSOLE INPUT ROUTINE USING CP/M BIOS 


3 
INFUTT 3 
INPUT23 


INS? 


FUSH 
FUSH 
FUSH 
LXI 
FUSH 
LHLOD 
LXI 
DAD 


H 


sSAVE REGISTERS 


gRETURN ADDRESS 
sFPUT ON STACK 
9RIOS WARM START 
sOF FSET TO INFUT 
sADN IN 

sCALL BIOS 
#RESTORE REGISTERS 


jABORT? 
9YES 
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581E 
S81iF 
5820 
5821 
5824 
5825 
5828 
582K 
582C 
5820 
582E 
582F 
5830 
5831 


5832 
5833 
5836 
5839 
5a3C 
583E 
5841 
5844 
5846 
5849 


584C 
5584p 
5B4E 
584F 
5850 
5851 
5852 
5855 
5856 
5859 
585c 


3890 


585E 


S85F 
9860 
3861 
9862 


ES 
ns 
CS 
212058 
ES 
2A0100 
110300 
i? 
E? 
Ci 
[4 
Ei 
B7 
Cc? 


FS 
CULESS 
CA4CS8 
Ch0é658 
FE1S 
C23358 
Ch0658 
FELL 
C24158 
C33358 


2A0100 
110900 
19 
Eg? 


fi “ae “a> 


NSTATS 


FUSH 
FUSH 
PUSH 


_ LXI 


8T33 


> Sp Wa 


OUTTs 
OUT2: 


OUTS: 


OUT4: 


OUTS: 


FUSH 
LHLD 
LXI 
DAD 
PCHL 
POF 
FOF 
FOP 
ORA 
RET 


FUSH 
CALL 
JZ 
CALL 
CFI 
JNZ 
CALL 
CFI 
JNZ 
JMF 


FOF 
FUSH 
PUSH 
PUSH 
MOV 
FUSH 
LXI 
FUSH 
LHLD 
LXI 
DAL 
FCHL 
FOF 
FOF 
FOF 
FOF 
RET 


Mime TrITreoclt 
“a 

, 8) 
==] 
Ch 


FSW 
INSTAT 
OUT4 
INFUT2 
CTRS 
OUT2 
INPUTT 
CTRA 
OUTS 
OUT2 


FSW 
H 
ft 


B 


CoA 
FSU 
HeOUTS 
H 

i 

Ig? 

It 


FSW 
B 
1) 
H 


GET CONSOLE-INFUT STATUS USING CF/M 


sSAVE REGISTERS 


sRETURN ADDRESS 
sFUT ON STACK 
>BIOS ENTRY 
OFFSET TO STATUS 
s;Ann TO ADDR 

sCALL BIOS 
sRESTORE REGISTERS 


CONSOLE OUTFUT ROUTINE USING CF/M BIOS 


gSAVE BYTE 
9 INPUT? 
gNO 

sGET INPUT 
eFREEZE? 
§NO 
PINFUT? 
sRESUME? 
3NO 


GET BYTE 
SAVE REGISTERS 


e>MOVE BYTE 


RETURN ADDRESS 
sPUT ON STACK 
gRIOS ENTRY 
sOFFSET TO OUTFUT 
sADLD TOGETHER 
gCALL BIOS 
RESTORE REGISTERS 


Some of the constants such as PORTN will not be used at this time. 
However, their inclusion now will simplify things later. There are four 
occurrences of the dummy instruction 


JZ 


WARM 
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following the label WARM. Each is followed by an instruction that will be 
needed later. These latter instructions are preceded by a semicolon so that 
they will be treated as comments by the assembler. . 

There are some other matters that may need to be considered. One has 
to do with the sense of the input and output ready flags. There are three 
conditional jump instructions based on console-ready flags that display a 
logical 1 (active high) when ready. If your flags are inverted, that is, they 
present a logic zero when ready, then the three JZ commands must be 
changed to JNZ commands. These lines, indicated by three stars in the 
listing below, should be changed to 


INPUTT? CALL INSTAT §CHECK STATUS 


JINZ INPUTT $sNOT READY xxx 
OUT2: CALL INSTAT ¢INFUT? 
JINZ OUT4 sNO KX 
- % ° > 
OUT 4 3 IN CSTAT gCHECK STATUS 
ANI ONSK 
JNZ OUT2 gNOT READY xxx 


The routine that corrects keyboard errors is programmed for a video 
console. If you have a console printer instead, change the backspace char- 
acter to a slash. 


BACKUF EQU <ft §CORRECTION 


This will print a slash when an error is corrected. Otherwise the printer will 
back up during error correction, overstriking the old character with the new. 
You may also need to add some nulls after each carriage return. The prob- 
lem here will be evidenced by missing characters at the beginning of each 
line. The solution is to place additional instructions in the subroutine called 
CRLF. Replace the last statement in this routine with the following. 


CALL OUTT pSEND LINE FEED 
XRA A GET A ZERO 
CALL OUTT $SEND NULL 

CALL OUTT SAND ANOTHER 

e 6 »® (one line for each null) 
JMP OUTT SLAST NULL 


The rest of the program can be copied directly as it is. The abort com- 
mand is a control-X. Initially, the abort address of HOME will be needed to 
leave the new monitor and return to your regular system. We will change 
this in version 3 when we will add a routine for branching to any memory 
address. : 

If you have a TRS-80 Model I, you won’t have a control key. There- 
fore, you will have to change several of the commands shown in the listing. 
The original commands follow. 


ce ttt tps 
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CTRH (Control-H) 


TAB (Control-I) 
CTRG (Contral-@) 
CTRS (Conmtral-§) 
CTRX (Controi-xX) 
DEL (DEL /RUB) 
ESC (Escare) 


After you have finished typing the program, exit from the editor and 
assemble the source program with the assembler. The command line might be 


B>AtASM MONI 
or 


B>AIMAC MONI 


for the Digital Research assemblers. These two assemblers will produce two 
files. 


MON1 ASH Cassembly Listing) 
MONI .HEX (hex cade) 


In addition, MAC will produce a symbol table 


MONIL.SYM (symbol table) 


. Inspect the hex code given in the assembly listing to see that it matches 
the corresponding instructions given in this chapter. These 8080 listings have 
all been generated with the Digital Research assembler MAC. This assembler 
displays the hex code for 16-bit operands in the usual reverse order. The 
low-order byte appears first followed by the high-order byte. Thus: 


CDLIESS means CALL S81B and 
C38458 means  JIMP 3884 


By contrast, the assembly listing produced by the Microsoft assembler 
reverses the usual order of the two bytes. The high-order byte is given first; 
this is followed by the low-order byte. In this case, the listing 


CD 581s means CALL S8iB and 
C3 3884 means JIMP 5884 


_ The next step is to load the hex program into memory using the debug- 
ger. The CP/M command would be 


ByAt DDT MONL.HEX or 
B>AiSID MON1.HEX 
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Now branch to the beginning of the monitor using the debugger G command. 
G5800 


The first thing that the monitor will do is display the version number on the 
first line and a prompt symbol of > underneath it. 

Try out this first version by typing a series of letters and numbers. Each 
character that is typed should appear (echo) on the console. Try the correc- 
tion keys. Typing either a control-H (backspace) or the RUB/DEL key 
should back up the cursor on a video terminal. Type a carriage return. The 
prompt symbol should appear at the beginning of the next line. If all of the 
features are working properly, type a control-X to return to your regular 
system. If something appears to be wrong, carefully compare your assembly 
listing with the one given in Listing 6.1A. Don’t proceed to the next version 
until the current one is working. 


VERSION 2: A MEMORY DISPLAY 


A provision for exarnining the contents of memory will now be added. This 
routine is called a memory dump, or dump for short; it displays the contents _ 
of memory in both hex and ASCII notation. The dump feature is initiated 
with a command of D followed by the address limits in hexadecimal. For 
example, the statement 


2100 18F 


will dump memory from address 100 to 18F hex. The first address (100 
in this case) must immediately follow the letter D. A space is typed and 
then the second address (18F in this case) is entered. Leading zeros are 
unnecessary. . 

Each line will display 16 memory locations. The hexadecimal address 
of the first location will appear at the beginning of the line. Then the hexa- 
decimal representation of the contents will follow, two characters per byte. 
These are arranged in four groups of four bytes. The ASCII representations 
of the data will be given at the end of the line if printable. Otherwise, a 
period is given. A dump of the first line of the monitor might look like this. . 


=DS800 S80F (your command) 
5800 C3S5SC58C3 S558CDLié6 SS8CACSSS DRLLEGZF o\X+@Xe re Xe eXeees 


Use your system editor to make the necessary alterations and additions 
to version 1. First, change the version number at the beginning of the 
program. 


VERS EQU ‘2° §VERSION NUMBER 
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Next, locate the instruction 
JZ DUMP 


that follows the label WARM. Remove the semicolon at the beginning of 
this line. Also delete the line just before it that jumps to WARM. The region 
should now look like this. 


~ CALL GETCH 
CPI ‘Dp’ DUMP? 
JZ DUMP 


. ¢ e e + ® 


The remaining instructions, shown in Listing 6.2, will be placed at the 
end of version 1, just preceding the END statement. It might be easier to 
delete the END statement, type in the new code, and then add anew END 
statement. The END statement is usually optional, anyway. One of the sub- 
routines (READHL) will translate the dump limits from ASCII-encoded 
hexadecimal into binary. One routine gets both the start and the stop address 
(using READHL) then checks to see that the second address is larger than 
the first. If the second address is smaller than the first, then the task will be 
aborted. Subroutine OUTHEX will convert the binary data already in 
memory into ASCII-coded hex for output to the console. Subroutine TSTOP 
is used to determine when to terminate the dump process. Finally, an error 
routine (ERROR) will be needed in case an invalid character is entered by 
the user. 


Listing 6.2+ Memory disrlay 
3 DUMP MEMORY IN HEXARECIMAL AND ASCII 


9 
S8EC Ch2ns9 DUMF $ CALL RDHLDE sRANGE 


SBEF CD8359 BDUMP2: CALL CRHL NEW LINE 
VOF2 4E DUMP 3: MOV CoM sGET BYTE 
S8F3 CD9359 CALL OUTHX gPRINT 

Y8F6 23 INX H gPOINTER 
JBF7 7D MOV Ask 

S8F8 E60F ANI OFH §LINE END? 
S8FA CAOSS9 JZ BUMP 4 sYESr ASCII 
98FD E4603 ANI 3 9 SFACE 

S8FF CCBES9 Cz OUTSP § 4 BYTES 
9902 C3F258 JMPF DUMPS eNEXT HEX 
5905 CHBESS DQUMP4: CALL OUTSF 

9908 DS FUSH n 

S909 LIF OFF LXI Dy-10H sRESET LINE 
Ss70C 19 DAL it 

J9OD Ti FOF I . 
Y9VOE Chins? DUMPS: CALL FASCI sASCII DUMP 
9911 CDA7S9 CALL TSTOF 9 DONE? 

3914 70D MOV AgL >NO 

S915 ESOF ANI OFH sLINE END? 
S917 C20E59 JNZ DUMPS 9NO 


S91A CZEFS8 JMP DUMP 2 


7E 
FEF 
N22859 
FE2O 
h22A59 
JE2E 
C31B58 


Ch3859 


DA7 BS? 
C9 


CH4459 
DA7BS9 


Cncecss 
DA6859 
CDé6éR59 
DASES? 
2? 
2° 
29 
29 
BS 
éF 
C34959 


FEF? 
CA6B59 
FEFO 
C27B59 
Cl 

bi 

Cc? 


“Sb “MiP 


PASCI$ 


FASC2¢ 
FASCS3% 


Ss: 
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MOV 
CPI 
JNC 
CFI 
ANC 
MVI 
JMP 


Ag 
DEL 
PASC2 


FASC3 
Ar’.’ 
OUTT 


HISFLAY MEMORY BYTE IN ASCII IF 
* FOSSIBLEs OTHERWISE GIVE DECIMAL FNT 


sGET BYTE 
sHIGH BIT ON? 
gYES 


§CONTROL CHAR? 
§NO 
sCHANGE TO LOT 
*SENT 


GET Hel AND [tvsE FROM CONSOLE 
THAT I¥vE IS LARGER 


3 
9 CHECK 
3 


ROHL DE 3 
ROHL D2 ¢ 


3 
§ INPUT 
3 

READHL ¢ 


ROHL 2 3 


CHECK 


Aj “ao wp rao 


DHL 4: 


ROHL S 3 


CALL 
JC 
XCHG 
CALL 
XCHG 
RET 


Hel 


FUSH 
FUSH 
LXI 
CALL 
JC 
CALL 
Jc 
DAR 
BAD 
nan 
BAD 
ORA 
MOV 
JMF 


FOR 


CPI 
JZ 


HHL DE 
AvE 
L. 

AvD 

H 
ERROR 


INFUT Hel AND DtvE. SEE 
2 ADDRESSES ARE ENTERED 


’ READHL 
ERROR 


REATHL 


FROM CONSOLE 


D 
R 
H»d 


LeA 
REAL 2 


BLANK AT ENT 


APOS 
ROHLS 


3 Sees 


7b ~ H 
sHel BIGGER 


THAT 


SHel ; 
sONLY 1 ADLIR 
SAVE IN DeE 
iLtivE 

sFUT BACK 


§SAVE REGS 
gCLEAR 
9GET CHAR 
gLINE ENT 
*7TO BINARY 
§NOT HEX 
‘TIMES 2 
ITIMES 4 
*TIMES 8 
TIMES 14 
FALDT! NEW CHAR 


9NEXT 


§ APOSTROPHE 
gASCII INFUT 


(% %="O0%) AND OFFH 


ERROR 
B 


Q 


yNO 


sRESTORE 
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S96B 
s96N 
S96E 
5970 
S971 
I972 
y974 
3975 
3976 
y978 
297A 


J97B 
39721 
3980 


3983 


3986 
5987 
I9BA 


598B 


S9BE 
3990 


wPIS 
IDA 
S99S 
I99S 
S997 
3998 
JOOR 
I99C 
SIFE 
aPAO0 
vPAL 
SPAS 
IAA 


SESF 
CO1ESS 
C30058 


COB658 


ac 
CHP359 
an 


CH9SS? 


3E20 
C3158 


CHYCS? 


79 


EGOF 
C490 
27 
CE40 
27 


C3LES8 


SZ ay ar “ap 


TT] <a» ~e <> 


“a> ‘ar sao (J cp ae “er 


o 
<j 
=. 
~ 


CONVERT ASCIT 


IBs SUI 


CFI 
RET 


CHARACTERS TO BINARY 


70" sASCII BIAS 
7 = 0 
‘FOO 44 
# INVERT 
sERRORy > F 
10 
¢ INVERT 
$NUMBER 0-9 
rn ed | 
10 #SKIP ¢ TO 


LETTER A-F 


FRINT ? ON IMPROPER INFUT 


RROR: MMVI 


CALL 
JMF 


Ay“?! 
OUTT 
START gTRY AGAIN 


START NEW LINEs GIVE ADDRESS 


RHL ¢ CALL 


CRLF pNEW LINE 


PRINT Hel IN HEX 


s MOV 
CALL 


OUTLL: MOV 


C3 owe ap <a> C3 <a> “ao a 


CI we wa we oo 


Cet 
OUTHX 5H 
Col 


OUTPUT HEX BYTE FROM C AND A SPACE 


UTHEX: CALL 
OUTFUT A SPACE 


UTSPs MMVI 


JMP 


OUTHX 


As’ é 
OUTT 


OUTFUT A HEX BYTE FROM C 
BINARY TO ASCIT HEX CONVERSION 


UTHX: MOV 


RAR 


HEX1;: ANI 


CHECK FOR END» 
INCREMENT Hel 


AvC 

PROTATE 

§ FOUR 

BRITS TO 

§ RIGHT 
HEXi SUFPER CHAR 
Ael SLOWER CHAR 
OFH STAKE 4 BITS 
9OH 

PHAA TRICK 
40H 
OUTT 


Heyl MINUS Dee 
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a 


SPA? 23 TSTOP? INX H 
“9AB 7B MOV AE 
IIAP OS SUB L. Ee bk 
PAA 7A MOV AvD 
SIAB 9C SBE H * tf - H 
SIAC TO RNC sNOT DONE 
JPAD El FOF H sRAISE STACK 
SIAE C9 RET 
9 
UORL END 


Type up the new instructions, then, after you leave the editor, rename 
the new file. The CP/M command will be 


REN MON2.ASM=MON1.ASM 


Rename the backup file to its original name. 


REN MON1.ASM=MON1. BAK 


Assemble version 2 and load it into memory. Start it up by branching 
to the address of START. Again, the version number should be printed, and 
the prompt symbol should appear. Test the new feature by dumping a por- 
tion of the monitor. 


~DS800 S8SF 


Be sure to type a carriage return at the end of the line. Input errors can be 
corrected by typing a backspace or DEL. Check to see that the hex code 
displayed on the screen matches the assembly listing code. Most of the 
ASCII representation will be meaningless. But the section from 5842 to 
585A hex will read 


Ver 2 
Now test the scroll-freeze commands. Dump a large section of memory. 


“DO 1000 


Type a control-S as the data are being displayed on the console. The console 
screen should freeze. Now type a control-Q. The screen should again resume 
displaying the data. The commands of Control-S and control-Q will alter- 
nately freeze and resume the scrolling. 

Try the routine that checks for proper dump limits by typing a larger 
address first, then a smaller address. 


B300 200 
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As a result of this improper input, a question mark should be printed. Then 
_ the prompt will appear on a new line. If everything is all right, return to your 
regular system by entering a control-X. 

If version 2 does not perform satisfactorily, compare the hex code in 
your assembly listing with the values given in Listing 6.2 for the new code. 
Correct any errors, reassemble the program, and try it again. 


VERSION 3: A CALL AND GO ROUTINE 


Now that both hex-to-binary and binary-to-hex routines are available, we can 
easily include new features. A CALL routine and a GO routine will be added 
in version 3. These routines will allow you to branch to any address in mem- 
ory. The GO command will be useful for testing subroutines. For this latter 
command, the monitor warm-start address (WARM) is on the stack when the 
call is made. A subroutine can be called with the C command. The execution 
of an RET instruction at the end of the subroutine will cause a return to 
the monitor. 

First, change the version number to 3. Then find the instructions corre- 
sponding to the C and G commands after the label WARM. Remove the 
semicolons from the beginning of the lines that branch to CALLS and GO. 
Delete the prior lines that jump to WARM. The program should now look like 


CPT ’C’ sCALL? 
JZ CALLS 
CPI ‘G’ sGO? 
JZ GO ; 


The remaining lines of code (and some comments) are placed at the end of 
the source program just prior to the END statement. They are given in 
Listing 6.3. 


Listing 6.3. A CALL and a GO routine. 


$ ROUTINE TO GU ANYWHERE IN MEMORY 
? ALDRESS OF WARM IS ON STACK» SO A 
§ SIMPLE RET WILL RETURN TO THIS MONITOR 
5 
SOAF E1 GOs FOP H gRAISE STACK 
S9BO CD4459 CALLS: CALL READHL GET ADTIRESS 
-S9BS ED FCHL °G0 THERE 
3 
S9B4 END 


Another importartt change should be made at this time. Since we can 
now branch to any place in memory with the GO command, we can change 
the abort command, control-X. Redefine HOME near the beginning of the 
source program so that an abort command of control-X will restart the 
monitor. | 
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HOME EQU ORGIN SABORT ADDRESS 


This line was originally entered as a comment. Remove the semicolon at the 
beginning of the line and delete the previous line. 

Assemble the new version and load it into memory. Branch to the — 
monitor and try the dump routine as before. Try the CALL feature by 
calling the monitor itself. 


*>C5800 


The cold-start message should appear. Now use the GO routine to return to 
your main system. If the GO address is zero, then no argument need follow 
the G command. 


>G6 
» 
Pa 


VERSION 4: A MEMORY-LOAD ROUTINE 


In version 2 we added a routine that could be used to inspect any memory 
location. A routine which can be used to change memory will now be added. 
Change the version number to 4. Locate the instruction 


9 JZ LOAD 


following WARM. Remove the semicolon at the beginning of the line. Delete 
the original JZ WARM on the prior line. The program should now look like 


CFI ‘L? 
JZ LOAD 


Add the load routines shown in Listing 6.4 to the end of the source program. 


Listing 6-4. A memory-load routine. 


LOAD HEX OR ASCII CHAR INTO MEMORY 
FROM CONSOLE. CHECK TO SEE IF 

THE DATA ACTUALLY GOT THERE 
APOSTROPHE FRECEEDS ASCII CHAR 
CARRIAGE RETURN PASSES OVER LOCATION 


“> > “I> <tr “Gp “ip 


J9RB4 CD4459 LOAD? CALL READHL sADURESS 
SPB7 CLBSS9 LOAD2: CALL OUTHL sPRINT IT 


J9BA CHADS? CALL FASCI yASCIT 
SPRL CH8ES9 CALL OUTSP 

S9CO 4E MOV CoM PORIG BYTE 
~9C1 CHERS9 CALL OUTHEX § #HEX 

v9C4 ES PUSH H sSAVE FNTR 
39CS CD7CS8 CALL INFL2 9 INFUT 
99C8 CD4459 CALL READHL ¢ BYTE 
S9CH 45 MOV Bel. ’ TOR 


‘sree CA A TAS MI A MAS Ht a Rc a sa SYP Dian EP en ne PPA 
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S9CC El FOF H 


S9CD FEF? CPI AFOS 

S9CF CADES? JZ LOAIG gASCII INPUT 
S92 79 MOV AsC SHOW MANY? 
S9D3 B? ORA A § NONE? 

59n4 CADAS? JZ LOADS sYES 

S9D7 CDESS9 LOAN4: CALL CHEKM sINTO MEMORY 
SIDA 23 LOADS: INX H sPOINTER 
S9DE C3B/59 JMP LOAD2 


LOAD ASCII CHARACTER 


fr owe ep sce 


SIDE CUCCS8 OADG? CALL GETCH 
Y9EL 47 NOV ByA 
S9E2 C3U759 JMF LOABA 


COFY BYTE FROM B TO MEMORY 
AND SEE THAT IT GOT THERE 


CT) a> sr ar sae 


S9ES 70 HEKM: MOV MeB sPUT IN MEN 
S9ES& 7E NOV Av *GET BACK 
S9E7 RS CMF B ’ SAME? 
S9EB C8 RZ gYES 
SIEO C37B59 JM ERROR ’ BAL 

g 
SPEC END 


Meveapic version 4 and compare the assembly listing of the new part to 
Listing 6.4. Load the new program and branch to the beginning. Recheck the 
dump command by examining the new code for the load routine 


*DS9B4 SER 


Now try the load command. Great care must be taken when typing the load 
address. This command will actually change the contents of memory, includ- 
ing the monitor itself. 

Type the letter L, the hexadecimal address, and a carriage return. The 
response will be the address that was typed and the current contents of that 
memory location. The data are represented two ways: in ASCII and in hex. 
If the ASCII value is not a printable character, it is rendered as a period. 

The displayed location can now be changed by typing the new value 
and a carriage return. The data can be entered in several ways. It can be in 
the form of one or two hex characters. If more than two characters are 
entered, only the last two are actually used. This allows you to correct an 
error by continuing to type. Errors can also be corrected with the backspace 
or the DEL/RUB key. A single ASCII character can be entered into memory 
by preceding it with an apostrophe. 

As each new value and a carriage return is typed, the next address and 
the present data value will appear. In this way, a machine-language routine 
can be entered from the console. Of course, using an assembler is a more 
efficient way to generate a long program. But our load routine will be useful 
for making simple changes or for writing short routines. 
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The load command is terminated by typing a control-X (if you redefined 
HOME as ORGIN back in version 3). It is also terminated if you enter a 
nonhex character. Control then returns to the monitor. If the load command 
is used to revise existing code, another feature is useful. A carriage return is 
given without entering any data. The memory pointer then skips over the 
current location and the corresponding value is not changed. 

After each revised byte is entered into memory, the monitor checks to 
see that the new value is correct. If an attempt is made to write into pro- 
tected, nonexistent, or defective memory, the load process is terminated and 
a question mark is printed. 

Try the load routine by entering the following five bytes into a conve- 
nient location such as 4000 hex. 


SE 7 DS xXx C9 


This sequence corresponds to the assembly language program 


3EO7 MVI Ay? 
D3XX OUT XX 
Cc? RET 


The value of XX is the console-data address (CDATA in the source program). 
Check the code with the dump command. 


D4000 4004 
Now use the CALL command to execute the routine 
C4000 


The console bell should sound and control will return to the command level 
of our monitor. 


VERSION 5: USEFUL ENTRY POINTS 


Changes to the first four versions were made for the most pait by adding 
new instructions to the end of the existing program. For versions 5, 6, and 7, 
we are going to start the process over to some extent by inserting some new 
instructions in the middle of the existing program. 

At the beginning of the monitor there are two jump instructions. 


JMP COLD 
JMP WARM 


Entry points such as these are sometimes called vectors. The first jump to 
COLD is the initial, cold-start entry point into the monitor. Stack initiali- 
zation and printing of the sign-on message occur at this time. But other 
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housekeeping chores, such as interface initialization, could be performed in 
this section. The second vector causes a jump to WARM, a restart entry point 
that does not alter the stack pointer. 

We will now insert some additional vectors after these first two. The 
additional jumps will provide fixed entry points to useful subroutines in the 
monitor. These routines can then be easily called by other programs outside 
the monitor. Since these jump instructions are all at the beginning of the 
monitor, their addresses won’t change when the monitor is altered. Further- 
more, new vectors can be added to the end of the group without affecting 
those already present. 

Place the five jump instructions shown in Listing 6.5 at the beginning of 
the monitor just after the first two (START and RESTRT). 


Listing 6.5. Some useful entry roints. 


$ VECTORS. TO USEFUL ROUTINES 


a 
? 


3806 C32A58 COUT: JMP OUTT sO0UTPUT CHAR 
5809 C31558 CIN: JMP INPUTT ¢INFUT CHAR 
S80C C3N058 INLN: JMPF INPLN sINFUT LINE 
S80F C32559 GCHAR: JMF GETCH sGET CHAR 
9812 C3ECS9 OUTH: JMP OUTHX §RIN TO HEX 


y 


Reassemble the monitor, load it into memory, and try the DUMP, LOAD, 
and GO routines again to be sure that they still work. Now, when separate, 
external routines are written, they need not contain subroutines for console 
input, output, conversion of binary to hex, and so on. 

A character can be displayed on the console by calling COUT with the 
character in the accumulator. A single console character is obtained by 
calling CIN. The byte is returned in the accumulator. 

An entire line of characters can be easily obtained by calling the line- 
input entry INLN. As each character is typed, it is automatically printed on 
the console. The error-correction commands are available at this time. The 
backspace and DEL/RUB keys can be used to delete the previously typed 
character. A line is normally terminated with a carriage return. After the 
console-input buffer has been filled by a call to INLN, the GCHAR address 
can be called. 

A character is returned in the accumulator for each call to GCHAR. 
When the input buffer has been exhausted, the carry flag is set. Typing a 
control-X will abort a routine and return control to the monitor. Therefore, 
it is not necessary to include an abort routine in separate, external programs. 

The fifth new entry point will perform a conversion from binary to 
ASCII-coded hexadecimal. This will allow display of individual memory 
locations or any of the CPU registers. The byte to be converted is placed in 
the C register and the address of OUTH is called. The accumulator is also 
used by the conversion routine in this case, so it may be necessary to save 
the accumulator’s original contents on the stack by using a PUSH instruction. 
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Use the monitor to write the following short routine. This program will 
demontrate the new vectors. . 


3E07 MVI As? 
C30658 JMP COUT 


This program, which is similar to the one written in the last section, can be 
placed almost anywhere in memory. This time, however, there is no need to 
worry about the output device address since the monitor takes care of this. 
Branch to the routine by giving the monitor command of C and the address 


C4000 


The monitor output routine will ring the console bell, then cause a return to 
the address WARM. 

The monitor now contains a bare minimum of features. The DUMP, 
LOAD, GO, and CALL routines can be used to write and inspect simple 
routines. The several vectors located at the beginning of the monitor, allow 
easy access to useful subroutines within. These vectors will greatly simplify 
the task of writing and debugging simple routines. 

At this point, you may wish to go on to Chapter 8 and try some of the - 
routines discussed there. Otherwise, continue in this chapter as we add more 
features to the monitor. The new features will include memory fill and zero, 
memory search, ASCII load and dump, input from and output through any 
port, a memory test, byte replacement, and memory comparison. 


VERSION 6: AUTOMATIC MEMORY SIZE 


A routine that will automatically find the top of usable memory will be 
added for version 6. The routine is executed each time a cold or warm start 
is performed. The first byte of memory in each page of 256 bytes of mem- 
ory is checked, starting with page zero. The byte in memory is moved to the 
accumulator, complemented, then written back to the same memory loca- 
tion. The result is compared to the accumulator to see if it is the same. If so, _ 
then the byte in the accumulator is complemented back to the original byte 
and it is written back into memory. This effectively restores the original byte. 
Each page of memory is checked in this way until the monitor stack 
area is encountered or until defective, missing, or protected memory is 
found. The hexadecimal value of this top page is printed just preceding the 
monitor greater-than prompt (>). For example, if the monitor starts at 
5800 hex and the stack is located at 57A0, then the prompt will appear as 


v7 > 
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This routine provides a regular, continuous check on the memory size. It 
does not check all of the memory, but only the first byte of each 256 bytes 
of the page. Nevertheless, this check may point up potential problems. A 
more complete memory test program will be added in version 15. 


Listing 6.6. Automatic memory check. 


FIND TOP OF USABLE MEMORY. 

CHECK FIRST BYTE OF EACH FAGE OF MEMORY 
“STARTING AT ADDRESS ZERO. STOP AT STACK 
OR MISSING/DEFECTIVE/FROTECTED MEMORY. 

DISPLAY HIGH BYTE OF MEMORY TOF. 


o> “i> “SP “GOP GD “GP 


3865 210000 LXT HO sPAGE ZERO 
3868 0657 MVI BySTACK SHR 8 

SB6A 7E NFAGES MOV Ash §GET BYTE 

S86B 2F CMA § COMPLEMENT 

886C 77 MOV MA sPUT IT BACK 

386D BE CMF M sSAMET 

S86E C27858 JNZ MSIZE gNO»e MEM TOF 

9871 2F CMA sORIG BYTE 

59872 77 MOV MeA sRESTORE IT 

9873 24 INR H gNEXT PAGE 

3374 OS DCR B 

9875 C26A58 JINZ NPAGE gKEEP GOING 

9878 4C MSIZE3; MOV CoH sMEM TOF 

3879 CDOFS? CALL CRLF sNEW LINE 

3B7C CHECS9 CALL OUTHX gFRINT MEM SIZE 

S87F CBDOS8 CALL INPLN sCONSOLE LINE 

8882 Ch2559 CALL GETCH sFIRST CHAR 


a 
9 


Insert the new instructions shown in Listing 6.6 right after the PUSH H 
instruction that follows the label WARM. 


WARM: LXI HyWARM RET TO 
PUSH H § HERE 


Cadd new code here) 


If your assembler does not have the shift-right operation SHR, then just code 
the high half of the stack address. The second line in Listing 6.6 might look 
like this instead. 


MUI Ry S7H 


Assemble the new version. Check the assembly listing to see that the new 
additions are correct. Then try out version 6. 
The symbol table at this point follows. 
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symbols 3 

OOF7 APOS 0008 BACKUP 39RBO CALLS 0011 CDATA 
0011 CBATAD S9ES CHEK 384A COLT OOoor CR 
5983 CRHL S886 CRLF 0010 CSTAT 0010 CSTATO 
0008 CTRH 0011 CTRA 0013 CTRS 0018 CTRX 
QOO7F DEL S8EC DUMP S8EF TUMP2 S8F2- DUMPS 
2705 DUMP 4 S90E DUMPS 597B ERROR OO1EBR ESC 
S8EO GETC4 S8CC GETCH S9AF GO 399 HEX1 
9938 HHLDE 0000 HOME S7AS IBUFC 37A6 IBUFF 
J7A3 IBUFF OODR INC 0001 INMSK 387C. INFL2 
238983 INFLS S8C0O INFLB SBA8 INFLC S3BA2 INPLE 
9884 INPLI 3877 INFLN S80C INFUT2 S806 INPUTT 
3814 INSTAT QO0OA LF S9B4 LOAD S9R?7 LOAL? 
29TA LOADS S97? LOALA S9TE LOARSG S946R NIB 
0002 OMSK 2800 ORGIN 38icC OUT2 582A OUTS » 
3835 OUT4 Oons OUTC S98B OUTHEX 9986 OUTHL 
S993 OQUTHX S98A OUTLL S76E OUTSF S818 OUTT 
9928 FASC? 392A PASCS3 o91DB FASCI 97A0 FORTN 
3949 RDHL2 S9SE ROHL 99768 ROHLS 9930 RDHLD2 
29720) ROHLDE 9944 READHL 5803 RESTRT 00C9 RETC 
JBE2 SENIM 5840 SIGNON S7AO STACK 53800 START: 
0009 TAR 0018 TOF S9A7 TSTOF 0031 VERS 
3853 WARM 


VERSION 7: COMMAND-BRANCH TABLE 


Before incorporating additional features into the monitor, we should make 
a fundamental change in the command processor routine. This routine inter- 
prets the initial character of the command line. The routine looks for com- 
mands beginning with the letter D, C, G, or L. Five bytes of instruction are 
needed for each one of these commands. For example, the LOAD routine 
uses the instructions 


CPI L? 
JZ LOAD 


Since there are 26 letters of the alphabet, there will eventually be 26 times 
5, or 130 bytes needed if 26 different commands are incorporated. This 


approach is satisfactory for a short table, Sy there is a better approach when . 


there are many entries. 

An alternate method is to use a command branch table. This method 
only requires two bytes per table entry plus 23 bytes of decoding instruc- 
tions. The disadvantage of this method is that all 26 table entries will have to 
be allocated, even if only a few are needed. Thus, there may be a lot of 
unallocated table entries. 

Delete the 13 lines of program immediately following the command of 
CALL GETCH, just after the label MSIZE. 


108  8080/Z-80 ASSEMBLY LANGUAGE 


CPI pe $DUMP <delete 13 lines> <“s===! 
a % © ; i 
“e# @ ¢@ i 

JMP WARM sTRY AGAIN g{esesl 

The new code that will be added is given in Listing 6.7. Notice that there are 
26 table entries. Each line corresponds to one letter of the alphabet. At this 
time, most of the entries refer to the erro? routine called ERROR. This is 
because we have not yet incorporated many features. As new features are 
added to the monitor, these error references will be replaced by the desired 
subroutine names. 


Listing 6.7+ Command-branch table. 


MAIN COMMAND PROCESSOR 


* 
? 
o 
? 


5885 [641 SuI “RS sCONVERT OFFSET 
3887 DADAS9S Jc ERROR , <A 
388A FEIA CFI so ae «ie ue | 
388C D2D459 JNC ERROR $ > Z 

S88F 87 ADD A s DOUBLE 
5890 219058 LXI He TABLE sSTART 
5893 1600 MVI fed 
3895 SF MOV Evra sOF FSET 
3896 19 DAD D sADD TO TABLE 
S897 SE MOV Eo PLOW BYTE 
3898 23 INX H 

3899 36 MOV Ty M gHIGH BYTE 
SB9A ERB XCHG §$INTO Hel 
V89R EP PCHL §G0 THERE 


COMMAND TABLE 


wa} ap “Gd “GD 


S89C D4g9 ABLE: DW ERROR pA» ASCII 

SB9E D4s? DW ERROR 9B 

SJBA0 O9SA hw CALLS ¢Cy CALL SUBR 
S8A2Z 4559 DW DUMP *De DUMP 

3B8A4 D459 DW ERROR gE 

SB8A6 N459 DW ERROR 9Fe FILL 

S8A8 O8SA oe GO ’Ge GO 

SBAA DAS? ‘ DW ERROR SH» HEX MATH 
S8AC D459 Dw ERROR §Iy PORT INPUT 
SBAE D459 nw ERROR §Jv MEMORY TEST 
~S8BO D459 DW ERROR aK 

98B2 ODSA DW LOAB gL» LOAD 

SBB4 D459 DW ERROR $Me MOVE 

SB8R6 D459 DW ERROR aN 

S88 D459 DW ERROR #0» PORT OUTPUT 
S8BA D459? DW ERROR oF 

S8BC D459 BW ERROR gQ 

SBBE D459? DW ERROR ¢Rye REPLACE 
58C0O 1459 DW ERROR Se SEARCH 

S8C2 D459 DW ERROR aT 

5804 R459 DW ERROR aU 

98C6 D459 DW ERROR 5V»y VERIFY MEM 
S8C8 D459 Dw ERROR a 

S8CA D459 DW ERROR 9X» STACK POINTER 
S8CC D459 hw ERROR oY 


Y8CE D459 DW ERROR yZy ZERO 
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Generate the new version, assemble it, and compare the resulting assem- 
bly listing to the one given in Listing 6.7. Try out version 7. It should behave 
exactly like version 6. It will be a bit longer than version 6 at this stage, but 
it will not grow as rapidly as we add new features. In the remainder of this 
chapter, we will add the new subroutines to the end of source program. The 
label for the subroutine will be placed in the appropriate place of the com- 
mand branch table. 


VERSION 8: DISPLAY THE STACK POINTER 


By adding seven bytes of new code, we will be able to examine our monitor’s 
stack pointer. This will alert us to a possible problem with the monitor 
itself. We may find, for example, that as we use the monitor, the stack tends 
to grow up or down in memory, rather than remain in the same place. This 
is undesirable and indicates that we are not properly lowering or raising the 
stack somewhere in the program. For example, subroutine TSTOP increments 
the pointer then checks to see if the current task should be terminated. If so, 
the stack is raised with a POP instruction. Then a return instruction skips 
one level of subroutines, so that control returns to the address of WARM. 

Change the version number to 8. Also change the entry in the command 
table that corresponds to the command of X. This is the third from the last 
entry. Delete the word ERROR and replace it with the word REGS. 


DW REGS Xe STK POINTER 
Then go to the end of the source program. We will make a minor change in 
subroutine CHECKM, the last subroutine in the monitor. Then the new 
instructions will be added: Delete the END statement and the instruction 
just prior to the END statement. 

IMP ERROR § BAD 


Then add the new instructions as shown in Listing 6.8. 


Listing 6.8. Diselay the stack rointer. 


JAAS Fi ERRF ¢ FOP PSW sRAISE STACK 

SA43S SE42 ERRB? MVI As’ B’ 7 RAD 

9A4S CH2ASE8 ERR2 3 CALL OUTT 

SA4SSB CHE7S9 CALL OUTSF 

VJA4SB C3DFS9 JME OUTHL sPOINTER 
9 
§ DISPLAY STACK POINTER REGISTER 
5 

SA4SE 210000 REGS 3 LXI HO 

SAS1I 39 DAD SF 

YAS2 C3DFS9 JMP OUTHL 
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Reassemble the monitor and try it out. First give the X command (with no 
argument). Make a note of the value given for the stack pointer. Now, try 
other monitor features such as the dump and load commands. After each of 
these commands, give the X command to see that the stack pointer remains 
in the same place. 

Try the separate routine that rings the console bell. This routine, which 
was written for version 4, may have to be rewritten if it was destroyed by 
the assembler or the editor. Again, check that the stack pointer is still in the 
same place. When you are convinced that everything is all right, continue to 
the next version. 


VERSION 9: ZERO AND FILL ROUTINES 


In version 4, we added a routine that could be used to change individual 
memory locations, one at a time. We will now add a routine which will allow 
us to fill a portion of memory with a constant value. A separate command 
for zeroing memory is also added for convenience, even though this opera- 
tion could be performed with the FILL command. 

Change the version number to 9, then alter the two command table 
entries that correspond to the F (fill) and Z (zero) commands. 


tw FILL 5F» MEMORY 


Dw ZERO 3Zv MEMORY 


Add the new code shown in Listing 6.9 to the end of the program. 


Listing 6.9. Zero and fill routines. 


ZERO A PORTION OF MEMORY 
THE MONITOR AND STACK ARE 


a 
3 
a 
? 
a 
3 
A 
3 
Z 


PROTECTED 
SASS ChB4659 ERO: CALL RDHLDE sRANGE 
SASS 0600 MVI Br0 
DASA C3665A JMF FILL2 


FILL A PORTION OF MEMORY 


“F} <e> se ~as 


SASD CD7CSA ILL? CALL HLDEBC RANGE» BYTE 


SA60 FEF7 CFI AF OS sAPOSTROPHET 
SA62 CA7S5A JZ FILL4 gYES ASCII 
9A65 41 MOV Bel 

SA6S6 7C FILL2: MOV AvH yFILL BYTE 
SAG7 FES? CFI STACK SHR 8 ¢TOO FAR? 
SA6? B2N459 JNC ERROR gYES 

SASC CHISESA FILL3: CALL CHEKM gPUT» CHECK 
SA6F CDOOSA CALL TSTOF § DONE? 


SA72 C3665A JMP FILL2 § NEXT 


“ap 
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YA75S CH2559 FILL4¢: CALL GETCH sASCII CHAR 
SA7B 47 NOV Bra 
vA7? C346C5A JMF FILLS 


GET HyL DeE AND Brel 


Zap wa ar 


vA7C COBASA LOERC? CALL HLDECK RANGE 


YA7F DADAS? JC ERROR sNO BYTE 
JAB2 ES . FUSH H 

SASS CDYDS? CALL READHL ¢3RDQ INPUT 
JABS 44 MOV ByH *MOVE TO 
JA87 4D MOV Cel § BrCl 

JABS El FOF H 

JABS C9 RET 


GET 2 ADDRESSES» CHECK THAT 
ADDITIONAL DATA IS INCLUDED 


a > “ap Or ~we 


SABA CRYLS? LDECK: CALL HHL DE ¢2 ADDR 
VASD DADAS? JC ERROR #THAT’S ALL 
3AIO C3IB9S9 JMF RDHLD2 s#CHECK 


Assemble the program, load it into memory, and a it out. First, dis- 
play a portion of memory. 


>B4000 404F 
Then, zero out a part of this region. 
>Z4000 403F 


Display the region again to be sure that the zero routine is working. Now fill 
a portion of the previously zeroed memory with A5 hex bytes. 


>F4001 401E AS 

Again, dump this region of memory to ensure that the fill routine is working. 
>D4000 404F 

Finally, check the ASCII fill command by filling with a $ symbol. 


>F4020 402F °% 


As with the load command, ASCII input is preceded by an apostrophe. 


VERSION 10: A BLOCK-MOVE ROUTINE 


The next routine to be added will allow us to move a block data from one 
memory location to another. This is actually a duplication routine, since the 
original memory block will remain unchanged. As each byte is moved to the 
new location, a check is made to ensure that it actually got there. 
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pe rm 


First, change the version number to 10. Then add the new lines to the 
end of the source program. Change the branch table entry corresponding to 
the command of M. 


DW HOVE ¥Me MEMORY 


Insert the instructions given in Listing 6.10 to the end of the source program. 
Assemble the monitor and try it out. 


Listing 6.10. A block-move routine. 


§ MOVE A BLOCK OF MEMORY HelL-DeE TO Bel 
5 

SA93 CO7CSA MOVE: CALL HLDEBC #3 ADDR 

3AP6 CHAOSA MOVDN: CALL MOVIN 9MOVE/CHECK 


SAV? CDOOSA CALL TSTOF 3 DONE? 
SAPC 03 INX B 9NO 
SAPD C39465A JMPF MOVDN 
g 
DAAO 7E MOVIN: MOV Avil PRYTE 
SAAL O2 STAX B gNEW LOCATION 
SAAZ OR LDAX B 3 CHECK 
SAAZ BE : CMP M 91S IT THERE? 
SAAS CB RZ sYES 
SAAS 60 MOV Hy B sERROR 
SAAG 4°? NOV Lee INTO Hol 
SAAZ C3425A JMP ERRF sSHOW BAD 


The move command requires three addresses. These are the start and 
stop address of the source block and the start address of the destination 
block. For example, 


 ->M5800 S8FF 4000 


will move the first page of the monitor (5800 to 58FF hex) down to the 
address range 4000 to 40FF hex. 

The move routine is designed to move data downward. Thus the first 
byte of a block can be deleted by moving the remainder of the program 
downward by one byte. The command 


>M103 1000 100 


moves the memory block in the address range 103 through 1000 down three 
bytes to the memory range 100 through FFD hex. On the other hand, a 
block move in the upward direction must be done carefully. 

If the new block does not overlap the old, then there is no problem. 
But if there is an overlap, then the upward move will destroy some of the 
data. One possible solution to this problem is to first move the block down- 
ward until it is clear of the new upper block. Then move the block up to the 
desired location. Another possibility is to move the upper half of the block 
first, then move the lower half. 
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The best solution is to have a more sophisticated move routine. This 
routine should first determine whether the move is to be upward or down- - 
ward. If the movement is downward, then the move commences with the 
lower part of the block (as with the present program). But if the move is 
upward, then it should begin with the upper end of the block. The memory 
pointers should now move downward in memory. With this approach, the 
original data will be unaltered. This additional feature is more easily coded 
with the Z-80-block-move routines than with the 8080 instructions. 

We have not incorporated the upward-move feature at this time. In 
developing a system monitor, there must be a tradeoff between features and 
space. A minimum of idiot-proofing is necessary. But, if we want to have a 
monitor that will fit into 1K bytes of ROM, we will have to make some 
compromises. 

Notice that this move routine moves a byte from the source location 
into the destination location. It then reads the byte back from the new loca- — 
tion to see that it actually got there. If an attempt is made to move data into 
read-only memory, protected memory, or defective memory, the process will . 
be terminated. The address of the location will be printed following the 
letter B (for ‘“‘bad’’). 

If we want to retain this memory-checking feature, we will not be able 
to use the Z-80 block-move routines. The problem is that the Z-80 routines 
perform an automatic pointer increment after each byte is moved. If a 
memory check is desired, then the destination pointer will have to be backed 
up after each byte is moved. This will allow the newly moved byte to be 
checked. Finally, the pointer will have to be incremented again. 


VERSION 11: A SEARCH ROUTINE 


Sometimes it is necessary to find a particular data byte or address in memory. 
Or perhaps all occurrences of a data byte or an address within a memory 
block are needed. For version 11, we will add a hex search routine. Change 
the version number and the branch table entry for the letter S. 


DW SEARCH 5S» MEMORY 


Add the new instructions as given in Listing 6.11. 


Listing 6.11. Search for 1 or 2? butes, 


§ SEARCH FOR 1 OR 2 BYTES OVER THE 

* RANGE Hoek DvE. BYTES ARE IN Bet 

§ B HAS CARRIAGE RETURN IF ONLY ONE BYTE 

§ PUT SPACE BTWEEN BYTES IF Two 

§ FORMAT? START STOP BYTE1 BYTE2 

$ 
SAAA CL7CSA SEARCH’ CALL HLDEBC SRANGEs 1ST BYTE 
SAAD 04600 SEAR2: MMVI BeCR sSET FOR 1 BYTE | 
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SAAF DABBSA JC SEARS sONLY ONE 
SAB2 ES FUSH H 

DABS CD9DS9 CALL READHL j§#2ND BYTE 
SABG 45 MOV Bel sINTO C 
SAB7 E1 FOF H 

SABES 7E SEAR33 NOV Ash sGET BYTE 
SABD EB? CMF C SMATCH? 
SABA C2CFSA JINZ SEAR4 5NO 

SABD 23 — INX H 9YES 

SABE 78 HOV Ark pONLY 17 
SABF FEOD CFI CR 

SACI CACISA JZ SEARS gYES 


FOUND FIRST MATCH» CHECK FOR SECOND 


a> Sr GP 


5AC4 7E «MOV AsyM $NEXT BYTE 
SACS BS CMP R $MATCH? 
5AC6 C2CF5A JNZ SEAR4 NO 

g 
5AC9 2B SEARS! DCX H $A MATCH 
5ACA C5 PUSH B 
SACB CDICS? CALL CRHL SSHOW ADDR 
SACE Ci FOF B 
SACF CDOO5A SEAR4? CALL TSTOP $ DONE? 


SAD2 C3BSSA JMP SEARS §NO 


Our new feature will display the address of every occurrence of one or 
two chosen bytes. For example, the command 


>S$100 4FF OD 


will print the address of each occurrence of a carriage return (OD hex) over 
the memory block 100 to 4FF hex. The alternate command 


>SO FFFF 3E 10 


includes two search bytes. This command will look for the byte 3E followed 
by the byte 10 over the entire 64K-byte memory range. These two bytes 
might represent the 8080 instruction MVI A,10 or perhaps the address 
103E hex. 

Notice that if two search bytes are given in the command, they must 
be separated by a space. If the command is incorrectly given without the 
space between the bytes, the search will only include the second byte. For 
example, the command 


>S0O FFFF 3E10 


will be interpreted as a search for the byte 10 hex. This occurs because only 
the last two characters of the field are used. 
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VERSION 12: ASCII LOAD, SEARCH, AND DISPLAY 


At this time, the monitor is hex oriented, but it is capable of limited ASCII 
operations. For example, the DUMP routine gives both the hex and the 
ASCII representation of the data. The load and fill commands will accept 
ASCII characters when preceded by an apostrophe. In version 12, we will 
add three new ASCII commands: ASCII load, ASCII dump, and ASCII 
search. A continuous series of ASCII characters (a string), including a car- 
riage return, line feed, tab, and so on, can be entered directly into memory. 
A straight ASCII dump will render an ASCII portion of memory in its 
natural form. And we will be able to search the memory for one or two 
ASCIL characters. If the command line begins with the letter A, a branch 
will occur to a second command processor. The letter following the A will 
cause a jump to the desired task of dump, load, or search. 

Change the version number to 12 and the command table entry for the 
letter A. 


DW ASCII Ay DUMP, LOAD 
Type the code from Listing 6.12; assemble the new version and start it up. 


Listing 6.12. ASCII loads searchs: and disrlay. 
s ASCII SUB-COMMAND FROCESSOR 


$ ; 
YVADS CN2559 ASCII: CALL GETCH §NEXT CHAR 


SADS FE44 CPI us | Sk sTLISPLAY 
SADA CAO4ASE JZ ADUMF 

SsADD FESS CFI gas §SEARCH 
SADF CA2CSR JZ ASCS 

VAE2 FEAC CFI 7.’ 7LOAD 
DAE4 C2N4sg JNZ ERROR 


LOAD ASCII CHARACTERS INTO MEMORY 
QUIT ON CONTROL-X 


we SP “Se ‘op 


SAE? CHONSS CALL READHL sADDRESS 
YAEA CDIFS? CALL OUTHL sPRINT IT 
SAEN ChH1iS558 ALOH2: CALL INPUTT §sNEXT CHAR 
SAFO CN2A58 CALL OUTT gFRINT IT 
SAF S 47 MOV BRvA 3SAVE 
SAF4 CD3ESA CALL CHERM 7INTO MEMORY 
SAF? 23 INX H s>POINTER 
JAFS 7D MOV AsL 

SAFS E67F ANI 7FH sLINE END? 
vAFB C2EDSA JINZ AL OL. »NO 
VAFE CRDCS9 CALL CRHL sNEW LINE 
SBO1 C3EDSA JMF ALON2 


DISPLAY MEMORY IN STRAIGHT ASCII. 
KEEP CARRIAGE RETURN» LINE FEED» CHANGE 
TAB TO SFACE» REMOVE OTHER CONTROL CHAR. 


“Gp “Op “Gp “Gp “GP 
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SB0O4 Ch8659 ADUMP? CALL RDHLDE sRANGE 


3BO7 7E ADMF2: MOV Asi sGET BYTE 

3HO8 FE7F CFI DEL SHIGH BIT ON? 

SBOA D2265K JNC ALMP 4 9YES 

SROD FE20 CFI a sCONTROL? 

SROF N2235R JNC ALMP 3 3NO 

SB12 FEOD CFI CR sCARR RET? 

3B14 CA2ZSSB JZ ALIMFS sYES» OK 

SB17 FEOA CFI LF LINE FEED? 

SR1i9 CA235E JZ ALMPF 3 sYES» OK 

SB1iC FEO? CPI TAB 

SBIE C2265E JNZ ADMP4 sSKIP OTHER 

B21 3E20 MVI Ae’ ¢ sSFACE FOR TAR 
- SB23 CU2AS8 ADMP3: CALL OUTT sSEND 

SR26 CLOOSA ADMF4: CALL TSTOF DONE? 

SB29 C3075E JMP ALMP2 §NO 


SEARCH FOR 1 OR 2 ASCII CHARACTERS 
NO SPACE BETWEEN ASCII CHARS 
FORMAT: START STOP 1 OR 2 ASCII CHAR 


D wo «> ao ae we 


SB2C ChBé6S9 SCS¢% CALL RDHLDE  sRANGE 


SR2F Ch2559 CALL GETCH gFIRST CHAR 

SB32 4F MOV CrAé 

SR33 CD2559 CALL GETCH §2ND OR CARR RET 
SB36 DAADSA JC SEAR2 sONLY ONE CHAR 
JIBS? 47 MOV BoA §2NT 

SRSA C3BB5SA JMP SEARS 


Dump a section of memory with the regular hex dump command. Then 
enter a line of ASCII characters using the new ASCII load command. 


>AL4000 <carriade return 
4000 This is a test of the new “cr><lf> 
ASCII load routine. <er><lft> 


All of these characters will be deposited directly into memory, including the 
carriage returns and line feeds. Type a control-X to abort the task. Inspect 
the new addition first with the hex dump 


 >D4000 404F 


then inspect it with the new ASCII dump: 


>AD4000 404F 


Notice the difference. The ASCII dump. renders the data as it was originally 
_ typed. 

A carriage-return line-feed pair will cause a real carriage-return line-feed 
pair to be sent to the console. Tab characters are not expanded but are ren- 
dered as blanks (in line with our goal of reducing the monitor size). All 
other control characters are ignored. 
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VERSION 13: INPUT AND OUTPUT TO ANY PORT 


The load routines added in versions 4 and 12 allow us to change individual 
memory locations. And the dump routines added in versions 2 and 12 allow 
us to inspect individual memory locations. For version 18, we will add a 
routine to read any I/O port and another to send a byte to any I/O port. 
This feature will allow us to initialize and test I/O ports. 

The 8080 and Z-80 microprocessors can address 256 separate, 8-bit 
input/output ports. These ports are used for communicating with the con- 
sole, list, and tape devices. In addition, if there is a front panel, the switches 
are usually assigned to a separate data port. Also, some disk-controller 
boards use several I/O ports for communication with the CPU. 

It is more difficult to implement these I/O features on an 8080 CPU 
than on a Z-80. The reason is that the 8080 I/O instructions require the port 
address to be placed in memory immediately following the IN or OUT 
command 


DB 10 IN 10H. 
D3 11 Our 11H 


By comparison, the Z-80 can execute I/O instructions with the device 
address located in the C register. Nevertheless, we will implement the input 
and output instructions, at this time, using only 8080 code. 

The plan is to write the IN or OUT instruction in memory, write the 
port number in the next byte, then write a RET instruction in the third 
position. A call to the address of PORTN will then produce the desired 
effect. The routine that writes these bytes in the stack area is called PUTIO. 
Since we are developing a monitor that can be placed in ROM, we will have 
to perform the actual I/O instructions outside of the regular monitor code 
area. Three bytes of memory just above the stack were previously set aside 
for this purpose. They start with the address PORTN. 

A fourth routine is also needed. Subroutine BITS is used to wonvert the 
binary data read from the selected port into ASCII-coded binary characters. 
An IN command then prints on the console the port data in both hex and 
binary. For example, the command 


DIFF 
will give the front-panel switch setting in both hex and binary notation. 
FB 11110000 


The BITS routine can be coded more efficiently if a Z-80 CPU is available. 
This is because the Z-80 can shift data in the general- -purpose registers, as 
well as in the accumulator. This is discussed in Chapter 7. 

Change the version number to 138 and alter the branch table entries for . 
the letters I and O. 
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DW IPORT ¢Ie PORT INPUT 


¢ 


DW OPORT 90% PORT OUTFUT 


Add the new routines to the end of the source code. Assemble version 13 
and try it out. 


Listina 6.13. Ineut and outeut to any rort. 
INFUT FROM ANY FORT (8080 VERSION) 


SB30D CD9DS? PORT: CALL READHL #PORT 


9B40 40 MOV Crk sFORT TOC 
SB41 3EDB MVI Av INC 3IN CODE 
SB43 C4358 CALL PUTIO sSETUP INFUT 
B46 6F MOV Loa 

SB47 CNESS? CALL GUTLL #HEX VALUE 


FRINT L REGISTER IN RINARY (8080 VER) 


“a> Gp “oe 


SB4A 04608 BITS: MVI Br8 #8 BITS 

SB4C 7D BIT23 MOV Ark 

SB4D 87 ADL a sSHIFT LEFT 
SB4E 6F MOV Lea 

SB4F 3E18 MVI As‘O’/2 $HALF OF O 
SBS1 SF ADC A §ROUBLE+CARRY 
SBS2 CU2AS8 CALL OUTT gF RINT BIT 
SBSS 05 NCR B 

SB56 C24CSB JINZ RIT2 98 TIMES 
SBS? C9 RET 


QUTFUT BYTE FROM PORT (8080 VERSION) 
FORMAT IS? OvsFORTs BYTE 


QI a> <a wr oe 


SBSA CHODS? FORT? CALL READHL §sPORT 


SRSD 4D MOV Cel 
SRSE CIOS? CALL READHL DATA 
SB61 3ED3 MMVI AsOUTC sOUT OFCONE 


EMULATE Z80 INP AND OUTF FOR 8080 


“YJ <a> sar ~ae 


SB63 32A057 UTIO: STA PORTN sIN OR OUT CODE 
SR66 79 MOV Avl sPORT NUMBER 
SB67 32A157 STA PORTN+1 

SBG6A SEC? MVI AyRETC RET OPFCODE 
SBS6C 32A257 STA PORTN+2 

.SB6F 7D MOV AgL sOUTPUT BYTE 
SB70 C3A0S7 JMF PORTN sEXECUTE 


If you have a set of front panel switches, give the command 
>IFF 


and see if the bit pattern matches the actual switch setting. Next, try to ring 
your console bell by sending a binary 7. 


rents enemnmsncnesnanmaermnesintinianmsnmnatetnnmensarnnetattcntAcnbctA nA RAN AAaNaLACA CERRO TENET NANE SANSA A NCTA 
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O11 7 


The value of 11 should be changed to your console data port address if it 
is different. 

Modern serial and parallel ports need to be initialized before use. These 
initialization routines could be placed in the monitor cold-start routines. 
Initialization can also be performed with the new monitor output command. 
A Motorola 6850 serial port can be initialized for one stop bit with the two 
commands 


>010 3 <rpeset> 
7010 15 <set> 


where 10 is the address of the status/control port. 


VERSION 14: HEXADECIMAL ARITHMETIC 


A routine for obtaining the sum and difference of two hexadecimal numbers © 
will now be added. Change the version number to 14. Change the branch 
table corresponding to the entry H. 


BW HMATH He HEX MATH 
Place the remaining new lines at the end as usual. 


Listings 6.14. Hecadecimal addition and subtraction. 
HEXADECIMAL MATHs SUM AND DIFFERENCE 


3 
3 
YB73 CO91IS9 HMATHS CALL HHLIE 3TWO NUMBERS 


SEB7& ES PUSH H gSAVE Hel 
SB77 19 DAD D ’SUM 

YB78 COIFS9 CALL OUTHL sPRINT IT 
SR/7E E1 POF H 

JB7C 70 MOV AvL 

JB7D 93 SUR E 9LOW BYTES 
SB7E 6F MOV LeoAé 

SR7F 7C MOV AvH 

SBB80 9A SBR D 

SR81 67 MOV Hea sHIGH BYTES 
JB82 C3NFS9 JMP OUTHL s DIFFERENCE 


The new feature is executed by typing the letter H and the hex num- 
bers. The response is the sum and the difference. 


7HB000 4000 
C000 4000 
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VERSION 15: MEMORY-TEST PROGRAM 


Back in version 6, we installed an automatic memory-size routine. This 
‘addition performs a memory check of sorts by testing the first byte of each 
page. In version 15, we will add a more complete memory-test program. 
Change the version number and the branch table entry for the letter J 
(justification): 


BW JUST Je MEMORY TEST 


| Then, type in the new lines as shown in Listing 6.15. 


Listing 6.15. A memory-test Frrodram. 


MEMORY TEST 
THAT DOESN’T ALTER CURRENT BYTE | 
INFUT RANGE OF ADDRESSES» ARORT WITH “X 


Gb ‘GP “GP “Gr “Pp 


SESS C8659 JUST Ss CALL RDHLDE sRANGE 

9B88 ES FUSH H §SAVE START ADDR 
SB89 7E JUST2: MOV AyM sGET BYTE 

SJRBBA 2F CMA sCOMPLEMENT IT 
SBSB 77 MOV MA sPUT IT BACK 
YBSC BE CMP M eID IT GO? 
YVRED C2ASSB JNZ JERR 9NO 
SB9O 2F CMA sORIGINAL BYTE 
YB91 77 MOV MeA sFUT IT BACK 
JB92 7I JUST33 MOV Ask sPASS 

SRS 93 SUB E ¢ COMPLETED? 
SB94 7C MOV Av 

SB9S 9A SER D 

SB9IS 23 INX H 

SB97 DABISB JC. JUST2 9NO 


AFTER EACH PASS» 
SEE IF ABORT WANTED 


a> “Je “E> “Ie 


SRFA CH2558 CALL  INSTAT ¢INPUT? 

SRPD C41i558 CNZ INFUTT ¢YES* GET IT 
SBAO El FOF H ISTART ADDR 

SBA1 ES FUSH H *SAVE AGAIN 
JBAZ C3895SKR JMP JUST2 gNEXT FASS 


FOUND MEMORY ERROR: FRINT POINTER ANT 
BIT MAP: O=GOODs 1=BAD BIT 


C.. > “er sap sae 


SBAS FS ERR S$ FUSH FSW *SAVE COMPLEMENT 
SEAS CHDCS9 CALL CRHL SPRINT FOINTER 
SBA? F1 POP FSW 

SBAA AE XRA M sSET BAD BITS 
SBAB ES FUSH H sSAVE POINTER 
SBAC 6F MOV Ly»A gRIT MAP TOL 
SBAL CO4ASK CALL BRITS yPRINT BINARY 
SBRO E1 FOP H 

VBE C3925R JMF JUSTS ’ CONTINUE 
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soeenirnterwt 


Assemble the program, load it into memory, and try it out. The mem- 
ory range from zero to 58FF hex is tested with the command 


~JO 5800 


This is a continuing test. The given range is tested over and over until aborted | 
with a control-X command. This memory-test program is not very sophisti- 
cated. The routine will not find unusual problems in flakey, dynamic mem- 
ories. It will, however, locate those regions with no memory, protected 
memory, and grossly defective memory. The address of each bad location is 
printed in hex, then the bit pattern follows. ASCII ones are shown for the 
bad bits and ASCII zeros are given for the good bits. 

The test program gets the original memory byte, complements it, and 
puts it back. It then complements it a second time and restores the original 
byte. Thus, the original memory is left intact. The only caution here is that 
the stack area should not be tested. 

Much more sophisticated memory test programs are needed for diffi- 
cult memory errors. Of course, such programs will require a lot of memory, 
and so would not fit into a compact system monitor. One feature of such a 
program is to provide a delay between the time the test byte is placed into 
memory and the time that the byte is checked. One disadvantage of a more 
powerful memory-test program is that it does not protect. the original 
memory contents. 


VERSION 16: REPLACE ONE BYTE WITH ANOTHER 


In version 11 we added a memory-search routine. This feature gives us the 
ability to find every occurrence of a particular byte. A companion feature 
added in version 16 allows us to change every occurrence of a particular byte 
to a different byte. Change the version number and the branch table corre- | 
sponding to the letter R. 


DW REPL gRy REPLACE 


Add the new lines shown in listing 6.16 to the end of the program. 


Listins 6.14. Reelace ane hex bute with another, 


§ REPLACE HEX BYTE WITH ANOTHER 
§ OVER GIVEN RANGE 
§ FORMAT IS: STARTs STOFs ORIG: NEW 


9 
SBB4 CH7CSA REPL ? CALL HLIEBC $RANGEs IST BYTE 
SRR? TALASS JC ERROR gNO 2NT! 
JRRA 41 MOV Bel 1ST TO RB 
YBBR ES FUSH H 
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SBRC CD9NS? CALL READHL s2NTI BYTE 
SBEF 40 MOV Col. eINTO C 
SBCO El FOF H 

SBC1 7E REFL2: MOV Arh sFETCH BYTE 
SBC2 BS CMF B 9A MATCH? 
~BC3 C2CCSB JNZ REPL 9NO 

SBCS 71 MOV MC sSUBSTITUTE 
SEC? 79 MOV Aryl 

SBC8 BE | CMF M 3 SAME? 

SBC? C2435A JNZ ERRE sNO* BAD 
SECC COOSA REPL3s CALL TSTOF § TONE? 

SRCF C3C1i5B JMP REPL 2 


Assemble version 16 and try it out. Move three lines of the monitor’s 
code to a lower place using the M command. 


>MS800 S82F 4000 


Dump these three lines of memory with the D command. 


>D4000 402F 


Change every occurrence of the byte C3 found in those lines to a 40 hex 
using the command 


*R4000 402F C3 40 


Notice that a space must separate the two bytes C3 and 40. Now, dump this 
portion of memory with the command 


>B4000 402F 


The new byte is an ASCII “at” sign (@), therefore it will show up clearly on 
the ASCII portion of the dump. 

The replace routine can be useful for relocating a short executable 
program. Suppose that a routine is programmed for execution at 3000 hex. 
It can be moved to 4000 hex with the block-move command 


*M3000 SFFF 4000 


However, the program will not run at the new location if there are absolute 
jumps present. The high byte of each jump address will have to be changed 
from 30 to 40 in this case. The search routine can be used to find all occur- 
rences of 30 hex in the program. 


784000 4FFF 30 


Then the replace command can be given to convert each 30 hex into a 
40 hex. 


*R4000 4FFF 30 40 
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Another use for the replace command is to convert an assembly lan- 
guage source file from one format to another. For example, the CP/M 
format requires a line feed to follow a carriage return. But another assembler 
may generate lines in which only the carriage return is placed at the end of 
each line. In this case, the original file can be loaded into memory. Then, all 
of the carriage returns (OD hex) can be replaced with an ASCII character 
such as a # symbol (23 hex). . . 


>R100 S8FF OD 23 


After the file is altered with the monitor, it can be saved on a disk. The final 
step can be performed with the system editor. The global replace command 
of this editor can be used to replace every occurrence of the # sign with a 
carriage-return/line-feed pair. With the Word-Master editor, the command 
would be 


KMRESANSOTT 


The first step required the monitor because the system editors cannot 
be directed to globally change a carriage return to something else. The 
carriage-return /line-feed pair must be treated as a unit. 


VERSION 17: COMPARE TWO BLOCKS OF MEMORY 


This last addition to our system monitor will fill out the size to just under 
1K bytes. The new routine will allow us to compare two blocks of memory. 
If discrepancies are found, the address and the contents of the appropriate 
location in both blocks will be shown. Change the version number and the 
branch table corresponding to the letter R. 


DY VERM gV 


Add the new lines shown in Listing 6.17. 


Listing 6.17. Compare two blocks of memory. 


§ GIVE RANGE OF 1ST BLOCK 
§ AND START OF SECOND 


? 


vBO2 CO7CSA VERM: CALL HLDERC #3 ANDRESSES 


SBOS OA VERM2: LUAX B sFETCH BYTE 

SBUG BE CMF Mi §SAME AS OTHER? 
JRO? CAF3SB JZ VERMS 8YES 

SBRA ES FUSH H sRIFFERENT 

OBDE CS FUSH B 
wENC CHDCS9 CALL CRHL sPRINT 1ST POINTER 
VBOF 4E NOV CoM sFIRST BYTE 

SBEO CHE4S9 CALL OUTHEX <sFRINT IT 


JRES SESSA NVI Ags’3? 
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SBES 
JBES 
SBE? 
aBEC 
SBED 
SBF O 
SBF i 
SBF 2 
UBF 3 
SBF 6S 
SBF? 


Ch2Aa58 
El 


CDOOSA 
03 
C3D55E 


VERNS$ 


CALL 
FOF 
CALL 
MOV 
CALL 
NOV 
MOV 
FOF 
CALL 
INX 
JMP 


Col 
OUTHX 
Cel 
Be 
H 


TSTOP 


B 
VERM2 


The symbol table should now look like this. 


SRO? 
JAED 
0008 
0011 
3858 
IIOF 
0011 
S9AS 
3967 
5A42 
SA6C 
5925 
SA7C 
S7AG 
0001 
5901 
S818 
SBAS 
000A 
SA3O 
JAAO 
0002 
5839 
SPE 4 
S9E7 
I976 
S9B7 
S99 
SBCC 
DABS 
I9 SB 
0009 
SBD2 
5861 


ADMP2 
ALOD2 
RACKUP 
CBATA 
COLn 
CRLF 
CTR 
DUMP 
DUMPS 
ERRF 
FILLS 
GETCH 
HLIERC 
IBUFF 


SB23 
OOF 7 
SB4C 
0011 
5806 
0010 
0013 
3948 
SAAS 
OO1B 
IA7S 
3A08 
SABA 
37AS 
5805 
J8FRB 
9815 
SB8S 
sAOK 
IAS? 
3878 
SBSA 
5844 
S9LF 
JBLA 
37A0 
99C1 
DASE 
3803 
SACF 
J84F 
389C 
JBDS 
SASS 


RESTRT 
SEAR4 
SIGNON 
TABLE 
VERM2 
ZERO 


SB26 
ZADS 
UB4A 
BASE 
oo0o0n 
0010 
0018 
J94B 
DAA 
SASD 
JB0F 
IPF 
9B73 
OODR 
SSF 1 
28nn 
3825 
JIBB9 
SALO 
SAPS 
o9PC4 
3800 
O0ODs 
S9EC 
3981 
3B63 
3989 
SBB4 
o00c? 
SACP 
37A0 
0018 
SBFS 


sBeC TO Heb 
sSECOND POINTER 


s2ND BYTE 
sPRINT IT 


sRESTORE C 


SAND B 
jAND Hel 
DONE? 


s2ND POINTER 


ALMPF4 


INSTAT 
JUST? 
LOAD? 
MOVIN 
NIB 
ORGIN 
OUTC 
OUTHX 
PASC2 
PUTIO 
RDHLD2 
REPL 
RETC 
SEARS 
STACK 
TOF - 
VERM3 


SBO4 
SR2C 
5A09 
5809 
59 DC 
0008 
OO7F 
595E 
5904 
5A66 
5939 
5991 
S7A5 
580c 
5919 
Seno 
5R3N 
SRI? 
5A33 
5A9S3 
586A 
582k 
5812 
SES 
5983 
59A2 
5986 
SEC1 
SAAD 
SAAA 
5800 
5A00 
3731 


ARUMP 
ascs 
CALLS 
CIN 
CRHL. 
CTRH 
NEL 
BUMP A 
ERROR 
FILL2 
GETC4 
HAL DE 
IBUFC 
INLN 
INPLE 
INPLN 
TPFORT 
JUSTS 
LOADS 
MOVE 
NFAGE 
OUT2 
OUTH 
OUTLL 
PASCS 
RBHL 2 
RDALDE 
REPL2 
SEAR2 
SEARCH 
START 
TSTOP 
VERS 


Try the new addition by first moving a copy of the monitor down to a lower 
memory location. 


2M5800 SBFF 4800 


Then verify that the two copies are the same. 
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>V3800 SEFF 4800 


Of course this step is not necessary, since there is a verification step included 
in the block-move routine. Change one byte in the new location so that 
there will be a difference. 


>L 4620 
4820 . XX 0 <zero location 4820> 
o © » AX fauit> 


Then, give the verification command again. 


*V5800 SBFF 4800 


Because you changed one byte of the copy, there should be an indication 
of error. . . ; 

This compare routine completes the 1K 8080 system monitor. We have 
incorporated many useful features into a minimum of space. We have care- 
fully distinguished program code from data code so that the monitor can be 
placed into ROM or PROM. 


AUTOMATIC EXECUTION OF THE MONITOR 


If you program the monitor into ROM, it will be ready to use each time the 
computer is turned on. On the other hand, you may want to copy it from. 
disk into memory each time it is needed. We have been loading the monitor 
with the system debugger each time it is needed. But it is easier to include a 
short loader program at the beginning of the monitor. Then you can execute 
the monitor just by typing its name. 

A suitable loader program is given in Listing 6.18. Type the program 
into your editor. There are two locations that need to be matched to your 
monitor; these are the addresses of START and FINAL. START must corre- 
spond to the first address of your monitor. The address FINAL is the last 
address of the monitor. 


Listing 6.18. Loader frrogram to move the monitor. 


B00 = START EQU J800H sMONITOR START 
JBFF = FINAL EQU JBFFH sMONITOR ENT 
AG20 = OF FST EAU 120-START sLOAD OFFSET 
9 
0100 ORG 1OOH sSTART HERE 
3 
0100 210058 LXI HeSTART #NEW START 
0103 012001 LXI Bei20H FOLD START 
0106 11FFSB LXI Do FINAL 
3 
0109 OA LOOP? LTIAX B GET A BYTE 
010A 77 MOV MeA TO NEW PLACE 
O10B BE CMP M sDID IT GO? 


ETI CLEC L TLA  AE ECT OE  STORaAA AI EAA ETS AC TRA TL TSO SH POAT mE APs Teter iE RPUASPTVGE tei AAS 4 
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010C C20000 JNZ 0 NO» QUIT 
O10F 23 INX H § INCREMENT 
0110 03 INX B § POINTERS 
“O111 7B MOV AVE sDONE? 
0112 95 SUB L 
0113 7A MOV ArT 
0114 9C SBE H 
0115 0120901 JNC LOOP sKEEF GOING 
0118 C30058 JMP START § DIONE 
5 
—OL1B ENT 


Assemble the loader program, then load it into memory with the debug- 
ger SID or DDT. 


A>DOT WMOVE.HEX 


Next, place a copy of the monitor into memory starting at address 120 hex. 
If the monitor is already in memory, a copy can be generated with the moni- 
tor itself. DDT or SID can also be used for this task. The command is 


M5800 SEFF 120 


If the monitor resides on disk as a hex file, it can be loaded with the debug- 
ger after you calculate the offset. The offset is necessary since hex files are 
normally loaded at the operating address, but we want to put it somewhere 
else. 

The required offset should be given in the assembly listing of the 
loader program as the value of the equate OF FST. If your assembler doesn’t 
print such values, then use the debugger to calculate the value. 


H120 5800 <starting value of monitor> 
5920 AP20 
<sum> <difference> 


Give the commands 


IMONL7+HEX 
R<offset> 


so that the monitor will be loaded starting at address 120 hex. 
Return to the CP/M system 


GO <do to zero> 
and save the combination 


ATSAVE 5 MONITOR.COM | 
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From now on, all you have to do is type the command 


A>MONITOR 


and the monitor will automatically start up. 

What actually happens is that the combination of the monitor and the 
loader program is first copied into memory at 100 hex. The move program 
relocates. the monitor from address 120 hex to its proper place. Then control 
is transferred to the monitor. As each byte is moved to the new location, it 
is checked to see that it actually got there. If not, the process is terminated 
and control returns to CP/M. 

This short loader can be placed on the front of any program that must 
be relocated. Only the first two instructions may have to be changed to 
reflect the proper starting and ending addresses. 

In the next chapter, we will convert our monitor to Z-80 code. The 
Z-80 version will be smaller so that we can incorporate a few additional 
features and still be able to fit the program into 1K of ROM. The features in 
the next chapter can be incorporated in the 8080 version, but they will take 

so much space that the monitor will no longer fit into 1K bytes. 


CHAPTER SEVEN 


A Z-80 System 


The system monitor developed in Chapter 6 contains many features. Since 
the size is less than 1,024 bytes, it will easily fit into a 1K PROM, such as 
the 2708 EPROM. It can then be ready for use as soon as the computer is 
turned on. But, in this case, it may be necessary to include a routine to 
initialize the peripheral ports, such as those that handle the console and 
printer. In addition, you might want to send output to a printer as well as 
to the video console. If these two features are added to the monitor, the 
size will increase beyond 1K bytes and it will not fit into a single 1K PROM. 

One way to add these new features without increasing the monitor’s 
size is to remove some of the original routines. Another way, if you have a 
Z-80 CPU, is to convert some of the instructions to the more compact Z-80 
equivalent operations. The latter approach will be followed in this chapter. 
Listing 7.1 gives the final version with all changes discussed in this chapter. 
The symbol table at the end can be used to find the routines of interest. 


Listing 7-1 The Z-80 version of the system monitor, 
TITLE Z-80 SYSTEM MONITOR 


(late soes here) 


FOUR SECTIONS HAVE BEEN REMOVED: 


VERS EQU eee (1 LINE) 
SIGNON: eee (4 LINES) 
LXI Ds SIGNON (2 LINES) 
SENDM? eee (6 LINES) 


ONE SECTION HAS BEEN ADDED: 
LIST QUPUT ROUTINES 


a> “ip “Gp “> “Ge “> “EP “GP “ih “ie “ie ~<a 


0018 TOF EQU 24 sMEMORY TOPs K BYTES 
97800 - ORGIN EQU (TOP -2)%1024 s%FROGRAM START 
3 


C3 
C3 
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ASEG 7ABSOLUTE CODE 
©Z80 
ORG ORGIN 
5 
STACK EQU ORGIN-60H 
CSTAT EQU 10H s>CONSOLE STATUS 
CATA EQU CSTAT+1 sCONSOLE TIATA 
INMSK EQU 1 yINFUT MASK 
OMSK EQU 2 sOUTPUT MASK 
LSTAT EQU 12H sLIST STATUS (18) 
LDATA EQU LSTAT+1 sLIST LATA (18) 
LONSK EQU 2 yOUTFUT MASK (18) 
NNULS EQU 4 ‘LIST NULLS (18) 
3 ; 
FORTN EQU STACK §CONS=0»LIST=1 
TRUFP EQU STACK+3 *RUFFER POINTER 
IBUFC EQU IBUFF4+2 $BUFFER COUNT 
IBUFF EQU IBUFF+3 ¢ INPUT BUFFER 
? 
CTRH EQU 8 5H RBACKSPACE 
TAR EQU FF 97 T 
CTRF EQU 16 5“F (18) 
CTRQ EQU 17 9 
CTRS EQU 19 9S 
CTRX EQU 24 § Xe ABORT 
RACKUP EQU CTRH  $ BACKUP CHAR 
DEL EQU 127 §RUBOUT 
AFOS EQU (39-'0O°) AND OFFH 
CR EQU 13 gCARRIAGE RET 
BS EQU 10 sLINE FEED 
? 
START: 

JF COLD sCOLD START 
RESTRT: JF WARM sWARM START 


¥ 
§ VECTORS TO USEFUL ROUTINES 


COUT: JP OUTT FQUTFUT CHAR 
CIN: JP INFUTT #¢INFUT CHAR 
INLN? JF INPLN sINFUT LINE 
GCHAR: JF GETCH sGET CHAR 
OUTH: JF OUTHX sRIN TO HEX 


9 
§ CONSOLE INFUT ROUTINE 

§ CHECK FOR CONTROL-P» LIST TOGGLE 
3 


INFUTT? CALL INSTAT §CHECK STATUS 

JR ZeINFUTT ¢NOT READY 
INFUT2$ IN As (COHATA) §$GET BYTE 

AND DEL 

CF CTRX sARORT? 

JR ZySTART #YES 

CF CTRF 9 "PP 

JR ZySETLST $LIST 

RET 


GET CONSOLE-INFUT STATUS 


Sp “a> “Gp 
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5827 
5829 
582k 


982C 
582F 
3830 
9833 


3835 
3836 
J839 
583A 
383C 
S83F 
3841 
5844 
JB4S6 
4848 
JB4B 
3841 
oB4F 


S851 
9853 
S855 
9857 
3858 
IB5A 


9B85B 
SBSE 


3861 
9863 
9865 
9867 
3868 
386A 
986C 


NB6E 
3870 
3871 
9872 
3874 
3874 
3877 
9879 


10 
01 


37A0 


a7A0 
EO 


J7A0 


iF 
5827 
10 
581A 
13 
F4 
5815 
ii 
F9 
ER 


10 
02 


ES 


11 


Fo 


INSTAT?: 


ETLST: 


GI wr ~<a 


UTT: 


OUT2: 


OUTS: 


OUT4: 


SEND 


fo ~ar sap sap ~op 


OUT: 


ap 


“a> “GD “GD 


OUTCR: 
OUTCR23 
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IN 
AND 
RET 


Lo 


Ar (CSTAT) 
INMSK 


TOGGLE LIST OUTPUT WITH CONTROL~P 


Avy (PORTN) §CHECK FLAG 
3 INVERT 

(FORTN) 9A # SAVE 

INPUTT gNEXT BYTE 


CONSOLE OUTFUT ROUTINE 


AF 

Avy (FORTN) §#WHERE?T 

A g ZERO? 
NZeLOUT §LIST OUTFUT 
INSTAT sINFUT? 


ZeOUT4 = §NO 
INFUT2 $GET INFUT 
CTRS gFREEZE?P 


NZsOUT2 §NO 
INFUTT INPUT? 


CTRQ sRESUME? 
NZ2OUTS #NO 

OUT2 

Avs (CSTAT) §GET STATUS 
ONSK 

Z90UT2 gNOT REARY 
AF 


(CLHATAd oA $SENTD BATA 


LIST OQUTFUT ROUTINE 


TO CONSOLE TOO 


CALL 
CALL 


IN 

AND 
JR 

FOF 
OUT 
OUT 
ANT 


ALL TIME DELAY 


INSTAT S INPUT? 
NZvyINFUT2 #YES» GET IT 


Avy (LSTAT) §CHECK STATUS 
OMSK 
Z9LOUT PNOT READY 


(LIATA)»A SSEND DATA 
(CDATA)»A sCONSOLE TOO 
7FH IMASK PARITY 


AFTER CARRIAGE RETURN 


CR CARRIAGE RET? 
NZ 5NO 

DE PUSE [tvE 

Dy30 * NNULS 

E» 250 

E 


NZsOUTCR2 ¢ INNER LOOP 
fl 
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387A 20 FB JR NZ,OUTCR OUTER LOOP 
987C Di FOF NE . sRESTORE 
§870 C9 RET 
9 
§ CONTINUATION OF COLD START 
9 
S87E 31 S7A0 COLD? LD SF» STACK 
? 
§ INITIALIZE 1/0 FORTS 
9 
9881 3E 03 Lu Ars 
3883 03 10 OUT (CCSTAT) »A SRESET 
9885 03 12 OUT (LSTAT) 2A 
1887 3E 15 LOD Av1iSH 
3889 03 10 OUT (CSTAT) *A §SSET 
88k 03 12 OUT (LSTAT) 9A 
~88D AF XOR A »GET A ZERO 
S88E 32 3S7A0 LD CFORTN) »A SRESET 
? 
§ WARM-START ENTRY 
? 
Y891 21 5891 WARM: LD HLsWARM sRET TO 
u894 ES PUSH HL ¢ HERE 
3 
¢ FIND TOP OF USABLE MEMORY. 
¢ CHECK FIRST BYTE OF EACH PAGE OF MEMORY 
§ STARTING AT ADDRESS ZERO. STOF AT STACK 
§ OR MISSING/DEFECTIVE/FROTECTED MEMORY. 
¢ DISPLAY HIGH BYTE OF MEMORY TOF. 
? 
8895 21 0000 Lo HL »0 ‘PAGE ZERO 
S898 06 57 Lo BsHIGH STACK sSTOF HERE 
S89A 7E NFAGE: LOD Avs(HL) sGET BYTE 
J89R 2F CPL COMPLEMENT 
389C 77 LI (HLJ»A SFUT IT BACK 
vB9D BE CF CHL? 9SAME? 
S89E 20 O05 JK NZ*MSIZE $NOe MEM TOF 
I8A0 2F CPL sORIG BYTE 
J8Al 77 LI (HL sA FRESTORE IT 
UBAL 24 INC H gNEXT PAGE 
JBAZ 10 FS DINZ NFAGE #KEEP GOING 
S8AS 4C MSIZE: LOD CvH sMEM TOP 
YBAG CD S935 CALL CRLF sNEW LINE 
SBA? CO S9FS CALL OUTHX 7FRINT MEM SIZE 
S8AC Ch S8Fr CALL INPLN #CONSOLE LINE 
“BAF Cl S949 CALL GETCH sFIRST CHAR 
7 
* MAIN COMMAND FROCESSOR 
, 
J8R2 016 41 SUB ‘AS sCONVERT OFFSET 
98B4 DA S9EO JF C»sERROR ¢ < A 
S8B7 FE 1A CF ‘ZI AC HI 
S8R9 D2 SP9EO JF NCrERROR * > Z 
S8BBC 87 ADT AvA > DOUBLE 
S8BD 21 S58C9 Lit HLsTABLE #START 
38CO 16 00 Lo D990 
38C2 SF Lo EvA ?OF FSET 
38C3 19 Ang HL » DE sADD TO TABLE 


NE LLL Le rent Ss rn nman inners encase temannesacancteteaetyeagansnaanntnsntarmi 
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38C4 
98C5 
§BCS 
38C7 
98C8 


58c9 
58Ck 
5ecnu 
S8Cr 
veBp1 
S803 
S8n5 
5807 
5809 
5S8Hk 
5800 
SSnr 
S8E1 
58E3 
S8ES 
S8E7 
SSE9 
S8ER 
S8ED 
S8EF 
S8Fi 
58F3 
S8FS 
5SOF7 
SSF? 
SSFR 


SS8FD . 


SOFF 
3902 
3909S 
3908 
vPOA 
S900 
POF 
o911 
3913 
99715 
wF17 
u?19 
J91B 
-S91ic 
SPLE 
OIF 


og “> “GP “aD 


“ib “Jp “Gp “Ge “Ge ‘Gp “GE 


INFLNG 


INPL23 


INFLI3 


INPL33 


ABLE? 
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COMMAND TABLE 


INPUT A LINE FROM CONSOLE 
INTO THE BUFFER. 
RUBOUT OR 


THE LINE. 


CARRIAGE 


gLOW BYTE 
sHIGH RYTE 


gINTO Hel 
’GO THERE 


DUMP ¢ LOAN 


SUBROUTINE 
DUMP 


MEMORY 
GO 


HEX MATH 
FORT INPUT 


LOA 
MEMORY 


REPLACE 
MEMORY 
VERIFY MEM 
STK PNTR 
MEMORY 


AND FUT IT 


LAST ENTRY. CONTROL~X RESTARTS LINE. 
CHARACTERS ARE IGNORED 


OTHER CONTROL 
Lo 

CALL 

Lo 


Agile’ 9PROMFT 

OUTT 

HL» IBUFF BUFFER ADIIR 
(IBUFP)sHL sSAVE FOINTER 
C20 s COUNT 

INPUTT sCONSOLE CHAR 
on ae ‘CONTROL? 

Ce INPLC +YES 

DEL § DELETE 
ZeINPLE #YES 

‘Zl gUPPER CASE? 
CoINPLS s YES 

3FH gMAKE UPPER 
(HL)sA INTO BUFFER 
Avr 32 sBUFFER SIZE 
C sFULL? 


ZyINPLI 


gYESs LOOP 


MEMORY TEST 


FORT OUTPUT 


RETURN ENDS 
“H CORRECTS LAST 


on 
li? 


v7AS 


C7 


08 


IPOD 
SPES 


INPLE? 


o 
5 
a 
3 
4 
3 
I 


NPLC? 


SP GP SGD 


a 
5 
a 
3 
« 
3 
C 


RLF ¢ 


a 
3 
a 
3 
od 
3 
I 


NPLES 


go Sp ib “p> “aD 


ETCH: 


GETC4? 


Sh “ip ‘OD 


DUMP ¢ 
DUMF 2 3 
DUMP 3$ 


Lo 
INC 
INC 
CALL 
JR 


LD 
LU 


LD 
CALL 
LE 
JF 
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Avy(HL) sGET CHAR 


HL. 3INCR FOINTER 
C SANT COUNT 
OUTT §SHOW CHAR 


INPLI gNEXT CHAR 


PROCESS CONTROL CHARACTER 


CTRH SCH? 
Ze INPLB #YES | 
CR $RETURN? 


NZvINFLI ¢NO» IGNORE 


END OF INFUT LINE 


As sCOUNT 
CIBUFC)»A #SAVE 


CARRIAGE-RETURN» LINE-FEED ROUTINE 


ACR 
OUTT *>SEND CR 
AgLF 

OUTT *SEND LF 


DELETE FRIOR CHARACTER IF ANY 


AsC sCHAR COUNT 

A 9ZERO? 
ZeyINPLI ¢YES 

AL sRACK FOINTER 
C SAND COUNT 


AsBACKUF #CHARACTER 
INFLE  3SEND 


GET A CHARACTER FROM CONSOLE BUFFER 
SET CARRY IF EMFTY 


HL §SAVE REGS 

HL CIBUFF) ¢GET FOINTER 
Ay (IBUFC) sAND COUNT 

1 sDECR WITH CARRY 
CeGETC4 §NO MORE CHAR 
CIBUFC) 9A sSAVE NEW COUNT 
As CHL) GET CHARACTER 


HL ?INCR FOINTER 
CIBUFP)»HL ¢AND SAVE 
HL sRESTORE REGS 


DUMF MEMORY IN HEXADECIMAL AND ASCII 


RUHLDE sRANGE 
CRHL gNEW LINE 
CyC(HL) s¢GET BYTE 
OUTHX gFP RINT 
HL sPOINTER 
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396A © 


396C 
S96E 
3970 
5973 
S975 
3978 
we79 
397C 
597 Tt 
SO7E 
3981 
3984 
S985 
5987 
3989 


U98B 
I98C 
J9BE 
3990 
S992 
P94 
3996 


IPP 
399C 
SOOT 
SIGE 
SOOF 
PAO 
S9A2 


SPAS 
SPAS 
SIAB 
SPA 
S9AC 
SIAL 


SIAE 
SIAF 
S9BO 
SIRS 
59RS 
S9RS 
SOBRE 
59RBR 
SOBE 


OF 
07 
03 
SPFS 
EF 
SOF S 


FFFO 
598R 
SAOC 
OF 


FS 
Lié 


SPAS 


3E 


SPAE 
38 


SORE 


0000 
S949 
1S 
S9D0 
08 


DUMP ¢ 


DUMPS 3 


G> “> “Ge “I> 


“Tl 


‘ASCT: 


FASC23 
FASC33 


“Se “Ge 


CHECK 
ROHLDE ¢ 
ROHLD2 3 


INPUT 


HLDE 


INFUT 


EADHL : 


ROHL 2 ¢ 


POSSIBLE + 


AND 


OFH 

Z» DUMF 4 
3 
Z»OUTSF 
DUMF 3 
OUTSF 
RE 
NE » ~10H 


OFH 
NZ» DUMPS 
RUMP 2 


Ay CHL) 
DEL 

NC »FASC2 
NC sPASCS 
Ay’.’ 
OUTT 


SLINE END? 
9YES» 
§SPACE 


a 


P 


4 RY 


ASCII 


TES 


sNEXT HEX 


sRESET LINE 


sASCII 
’ DONE? 
9NO © 

gLINE END? 


9NO 


DUMP 


DISFLAY MEMORY BYTE IN ASCII IF 
OTHERWISE GIVE RECIMAL FNT 


§GET BYTE 
sHIGH BRIT ON? 


gYES 


sCONTROL CHART 


9NO 


CHANGE TO OT 
7 SEND 


GET HyL AND DeE FROM CONSOLE 


THAT DvE IS LARGER 


HylL FROM 


PUSH 
FUSH 


HHL DE 
AVE 

L 

Avl 

AvH 
C»ERROR 


Dv& 


READHL 
CyERROR 
DE » HL 
READHL 
BE sy HL 


CONSOLE 


Cy RDHL 4 
HL » HL 
HL » HL 


gE - Lb 


$0) - H 
Hol. B 


§Hel. 
PONLY 1 ANDR 
SAVE IN ItvE 
SDvE 
sPUT BACK 


IGGER 


gSAVE REGS 
sCLEAR 
§GET CHAR 
gLINE END 
970 BINARY 
sNOT HEX 
gSHIFT LEFT 


a 


? 


FOUR 
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SORF 29 ADL HL » HL ¢ RYTES 
ICO 2° AL HL » HL 
99C1 BS OR L. ,ADD NEW CHAR 
U9C2 4F LO Lye 
$9C3-18 EE JR RDHL 2 §NEXT 

F 

§ CHECK FOR COMMA OR BLANK AT END 

; 
J9CS FE F? ROHL4: CF APOS 5 APOSTROPHE 
J9C7 28 O4 JR ZeRBHLS sASCIIT INPUT 
J9C9 FE FO CF (/ *-'0%) AND OFFH 
Y9CR 20 13 JR NZvERROR ¢NOT BLANK 
o9CN Ci RDHLS: POF BC 
S9CE Di POF De sRESTORE 
SJ9CF C9 RET 

? 

¢ CONVERT ASCII CHARACTERS TO BINARY 

P 
9900 2& 30 NIB: SUB °Q? sASCII BIAS 
S902 [8 RET C 5 < 0 
w9DS FE 17 CP 5 ara © alee 
S905 SF CCF 9 INVERT 
9906 Lg RET C gERRORs > F 
39n7 FE OA CP 10 
DIPLO SF CCF 9 INVERT 
Y9DA DO RET NC sNUMBER 0-9 
S90 D6 07 SUB 4A Het a1 
S9DD FE OA CP 10 gREMOVE ¢- 
S9DF C9 RET gLETTER A-F 

# 

¢ PRINT ? ON IMPROPER INPUT 

? 
SEO SE BF ERROR: LO Ay‘?! 
S9E2 CO S835 CALL OUTT 
J9ES C3 3800 JP START 3TRY AGAIN 


START NEW LINEs GIVE ADDRESS 


RHL 3 CALL CRLF gNEW LINE 


S9E8 CD 3935 


PRINT Heyl IN HEX 


> ae sap LJ <a> cae oe 


«2 


S9ER 4C OUTHL? LOD CrH 
S9EC CD S9FS8 CALL OUTHX 3H 
S9EF 4fi OUTLL? LOD Cel 


QUTFUT HEX BYTE FROM C AND A SPACE 
S9FO CD S9FS UTHEX: CALL OUTHX 


OUTFUT A SFACE 


Cj ae ae wr ES} sor ae co 


JIFSZ ZE 20 UTSP: LD Ar’ 7 
S9FS C3 S835 JF OUTT 


OUTFUT A HEX BYTE FROM C 
BINARY TO ASCII HEX CONVERSION 


“Q> “QD “Go “Pe 
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S9FE 79 OUTHX: LI AsvC 

SOFO IF RRA yROTATE 
S9FA IF . RRA © § FOUR 

S9FB iF RRA > BITS TO 
SOFC IF RRA § RIGHT 
o9FD CD SA01 CALL HEX1 SUPPER CHAR 
JANN 79 Lt AsC gLOWER CHAR 
JAOL ES OF HEX; AND OFH §TAKE 4 BITS 
SANZ CS 90 ADD As9OH 

YAOS 27 DAA sUAA TRICK 
9A06 CE 40 ADC As 40H 

JA08 27 LAA 

SA09 C3 S835 JF DUTT 


CHECK FOR END: Het MINUS Dive 
INCREMENT Hol 


omg “QD “te Ge ‘aD 


SAOC 23 STOF$ INC HL 
JAOL 7K Lo AGE 
JADE 9S SUB L Ae ee Be 
SAOF 7A Lo Avr 
3A10 9C SBC AvH ’ Tf - H 
wALL DO RET NC gNOT DONE 
SALl2 El FOF HL *RAISE STACK 
—SA13 CP RET 
3 
* ROUTINE TO GO ANYWHERE IN MEMORY 
* FOR CALL ENTRY» ADDRESS OF WARM 
* IS ON STACKs SO A SIMPLE RET 
§ WILL RETURN TO THIS MONITOR 
? 
SAL4 El GO? POP HL gRAISE STACK 
VAIS Cl S9AE CALLS? CALL READHL sGET ADDRESS 
wAIS ED JF CHL? *>GO THERE 


LOAD HEX OR ASCII CHAR INTO MEMORY 
FROM CONSOLE. CHECK TO SEE IF 

THE DATA ACTUALLY GOT THERE 
AFOSTROFHE FRECEEDS ASCII CHAR 
CARRIAGE RET PASSES OVER LOCATION 


Qe “Gb “rp “E> “Ge Ge “ip 


JALP Cl SPAE LOAD? CALL READHL ANDRESS 
SAIC Ch SSER LOAD23 CALL OUTHL sPRINT IT 


SALF CD S98R CALL FASCI gASCITI 
YA2Z2 CU SPFS CALL OUTSP 

JA2ZS 4E Lyi CeC( HL) sORIG BYTE 
5A26 CD S9FO CALL OUTHEX sHEX 

SA2ZS ES FUSH HL iSAVE PNTR 
JAZA CD 5902 CALL INPL2 s INFUT 
SAL CO S9AE CALL READHL ¢ BYTE 
3ASO 45 Lot Bol > TO RB 
9AS1 El FOF HL. 

YAS2 FE F7 CF APOS 

JAZ4 28 OA JR Z»LOADS FASCII INPUT 
IA36 79 Li APC gHOW MANY? 
SAS7 B7 OR A sNONE? 


VASB 28 03 JR ZyLOADS 5 YES 


SAAS 


he 


uPA 


F4 
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LOAT4A? CALL CHEKM sINTO MEMORY 
LOADS: INC HL. sPOINTER 
JR LOAD2 


LOAN ASCII CHARACTER 


fT sae san sae 


OADS? CALL GETCH 
Lu BrA 
JR LOADA 


COPY BYTE FROM B TO MEMORY 
ANI SEE THAT IT GOT THERE 


O° <p sap ae or 


HEKM: LI (HL)»R $FUT IN MEM 
Lo Ay(HL) ¥#GET BACK 
CF B 9SAMET 
RET z 90K 

ERRF 3 FOF AF sRAISE STACK 


ERRES Lo Ay “B’ ’ BAL 
CALL OUTT 
CALL OUTSP 


JP OUTHL sPOINTER 

9 

$ DISPLAY STACK FOINTER REGISTER 

9 

REGS? Lo HL. »0 
ADL HL » SF 
JP OUTHL 

p , 

$ ZERO A PORTION OF MEMORY 

3 

ZERO? CALL RBHLODE sRANGE 
LOD. Be 
JR FILL2 

3 4 

§ FILL A FORTION OF MEMORY 

3 

FILL: CALL HLDEBC $RANGEs BYTE 
CP APOS # APOSTROPHE? 
JR ZeFILL4 #YESs ASCIT 
Li ByC 

FILL2: LO AvH SFILL BYTE 
CF HIGH STACK #TOO FAR? 
JF NC s ERROR sYES 


FILL3$ CALL CHEKRM gPUT» CHECK 
CALL TSTOF sDONE? 


JR FILL2 §NEXT 

? : 

FILL4$ CALL GETCH gASCII CHAR 
Lot BA 
JR FILL3 

9 

§ GET Hel DeE ANT Bel 

3 

HLOERBC? CALL HLDECK RANGE 
JF CyERROR ¢NO BYTE 
FUSH HL. 
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9AB?7 Cl SPAE CALL READHL #3RD INPUT 


JABA 44 Lo Bel ‘MOVE TO 
SASB 40 Lf Ceol § Bel 
JABC E1 FOF HL 

SAGI CP RET 


GET 2 ADDRESSES» CHECK THAT 
ADDITIONAL DATA IS INCLUDED 


SABE Cli S9AS LOECK$ CALL HHL DE 92 ATDR 

VAIL TA SVEO JP CreERROR #THAT’S ALL 
DA94 C3 S99C JF ROHLD2 §sCHECK 

MOVE A BLOCK OF MEMORY Hel -DsvE TO Bel 


YAP? Cit SAGO MOVE: CALL HLDUEBC #3 ADDR 


JAPA CI SAAS MOVDN: CALL MOVIN §MOVE/CHECK 
SARL Ch SAOC CALL TSTOF sDONE? 
SAAD 03 INC BC gNO 
JAAL 18 F7 JR MOVDN 

¥ 
SAAS 7E MOVIN: LOD Avg(HL) sBYTE 
JAAS O2 Lp (EC)}»A §FNEW LOCATION 
JAAS OA LI Avy (BC) sCHECK 
AAG KE CP. CHL) IS IT THERE? 
vAA7 CB RET z 3YES 
SAAB 60 Lit Ho B sERROR 
SAAD 69 Li LeC S$INTO Hel 
SAAA C3 SA4A JP ERRF ySHOW BAR 


SEARCH FOR 1 OR 2 BYTES OVER THE 

RANGE Hslk DTeE. BYTES ARE IN Bel 

R HAS CARRIAGE RETURN IF ONLY ONE BYTE 
FUT SPACE BTWEEN BYTES IF TWO 

FORMAT: START STOP BYTE RBYTE2 


“a> “EF “E> “I> “OD SGP “iD 


SAAD Cle SABO SEARCH: CALL HLDEBC RANGE» 1ST BYTE 


SABO O06 OD SEAR2:3 LM By CR *SET FOR 1 BYTE 
SAB2 38 06 JR CrSEARS sONLY ONE 
SABA ES FUSH HL 

JABS Cl SAE CALL READHL #¢2ND BYTE 
YABB 45 Lot Bek gINTO C 
SAR? El FOF HL. 

SABA 7E SEARS: LO AyCHL) sGET BYTE 
JABB RB9 CF C §MATCH? 
SABC 20 10 JR NZ*eSEAR4 #NO 

JABE 23 INC HL gYES 

SABF 78 Lo Avk gONLY 17 
9ACO FE OD CP CR 

VACZ 28 04 JR Z9SEARS sYES 


FOUND FIRST MATCH» CHECK FOR SECOND 


“Se “ae “We 


SAC4 7E Lin AvyCHL) NEXT BYTE 
SACS BB CF B 9MATCH? 
SACS 20 06 JR NZ»SEAR4 #NO 


ar 
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SACB 2B SEARS: DEC HL 3A MATCH 
SAC? CS PUSH BC 
VACA Ch SSESB CALL CRHL sSHOW ADDR 
SACD Ci FOF BC 
SACE CD SAOC SEAR4; CALL TSTOF s TONE? 
vADL 18 E7 JR SEARS 9NO 
$ 
§ ASCII SUB-COMMAND PROCESSOR 
3 ; 
JADNS Ch S949 ASCIT: CALL GETCH sNEXT CHAR 
VALG FE 44 CF am Ls § DISPLAY 
YANS 28 24 JR Z» ADUMP 
JADA FE 33 CF ‘Ss? 5 SEARCH 
VYAIC 28 42 JR Z*sASCS 
SADE FE 4C CP “LS sLOAL 
YAEO C2 SVEO JF NZsERROR 
? 
§ LOAD ASCII CHARACTERS INTO MEMORY 
¢ QUIT ON CONTROL-X 
? 
SAES Cl S9AE CALL READHL ADDRESS 
DAES CD SPER CALL OUTHL sPRINT IT 
SAE? Ch S815 ALONG: CALL INPUTT #NEXT CHAR 
SAEC Cl S835 CALL OUTT gFRINT IT 
SAEF 47 Lou BrA 3 SAVE 
JAFO Cl SA4G CALL CHEKM INTO MEMORY 
SAFS 23 INC HL sPOINTER 
vAF4 7I LO Ark 
VAFS EG 7F AND 7FH sLINE END? 
SAF? 20 FO JR NZrALOD2 ¢NO 
SAF? CD SVE8 CALL CRHL sNEW LINE 
SAFC 18 ERB JK ALOD2 
? 
¢ DISFLAY MEMORY IN STRAIGHT ASCII. 
§ KEEP CARRIAGE RETURNs LINE FEED»: CHANGE 
¢ TAB TO SPACEs REMOVE OTHER CONTROL CHAR. 
3 
SAFE Ch S999 ATUMP:s CALL ROHLDE  #sRANGE 
9RBO1 7E ADMP2: LI Avy (HL) §GET BYTE 
SBO2 FE 7F CF DEL 3HIGH BIT ONT 
JBO4 30 15 JR NCvsADMF4 YES 
SRO6 FE 20 CF aN a §CONTROL? 
SBO8 30 OE JR NC sADMF3S #NO 
SBOA FE Of CF CR gCARR RET? 
SBOC 28 OA JR Ze AUMFP3 #YES» OK 
SBOE FE 0A CF LF LINE FEED? 
SB10 28 06 JR ZeADMPS FYESs OK 
SB1l2 FE 09 CF TAB 
YB14 20 O05. JR NZ»ADMP4 §SKIF OTHER 
9B16 SE 20 Lio Ar’ ¢ #SFACE FOR TAR 
3B18 Ch S835 AUMFP 3: CALL OUTT ’ SENT! 
SBiB CO SAOC ADMF4: CALL TSTOP 3 DONE? 
JRIE 18 El JR ADMF2 9NO 


“Gr “bp “Wb “Gp “ih 


SEARCH FOR 1 OR 2 


ASCII CHARACTERS 


NO SPACE BETWEEN ASCII CHARS 


FORMAT 3 


START STOF 1 OR 2 ASCII CHAR 
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SRB20 Ch S999 ASCcS: CALL ROHLDE #sRANGE 


VJR23 CO S949 CALL GETCH sFIRST CHAR 

9B26 4F LD Cra 

SB27 Ch S949 CALL GETCH g2ND OR CARR RET 
SB2A DA SABO JF CrSEAR2 s0NLY ONE CHAR 
SB20 47 LI BA 92ND 

YBZE C3 SABA JF SEARS 


INPUT FROM ANY FORT (Z-80 VERSION) 


SB31 CD S9AE FORT: CALL READHL sPORT 


YBS4 4D LD Crk SPORT TO C 
3B35 ED 48 IN Ly(C) ? INFUT 
SBS? CD S9EF CALL OUTLL pHEX VALUE 


3 
§ FRINT L REGISTER IN BINARY (2-80 VER) 


YBSA 06 08 BRITS: Li Br8 38 BITS 

SBSC CR 25 BIT23 SLA L. eSHIFT L LEFT 
“SB3E 3E 18 Lo Avy’O°/2 $HALF OF O 
.SB40 BF . ALC AvA > DOUBLE+CARRY 
SB41 CD 5835 CALL OUTT yPRINT BIT 
YR44 10 FSG DJINZ RIT2 98 TIMES 

JR46 C9 RET 


OUTFUT BYTE FROM FORT (2-80 VERSION) 
FORMAT IS: Ov» FORTs BYTE 


Ci a> sae ae ae 


B47 CO S9AE FORT: CALL READHL sFORT 
UB4A 40 LD Cok 

SB4B Ct S9AE. CALL READHL sDATA 
SR4E ED 649 OUT (Cook sOUTFUT 
SBSO C9 RET 


9 
¢ HEXADECIMAL MATH» SUM AND DIFFERENCE 
§ 


SBS1 Cht SPAS HMATHs CALL HHL DE §TWO NUMBERS 


JBS4 ES FUSH HL gSAVE Hel 
JBSS 19 ALT HL » DE > SUM 

JBS6 Cll SPER CALL OUTHL gPRINT IT 
YRSS Et FOF HL 

SESA B? OR A gCLEAR CARRY 
SBSER ED S52 SEC HL » DE 

JBS0 C3 S9YER . JF OUTHL sDIFFERENCE 


MEMORY TEST THAT DOESN‘’T ALTER CURRENT BYTE 
INFUT RANGE OF ADDRESSES» ABORT WITH “X 


Cap sae sae sae 


9B60 CD S999 USTs CALL ROHLDE s¢RANGE 


SB63 ES FUSH HL >SAVE START ADDR 
JB64 7E JUST2: LO AvyCHL) s5GET BYTE 

SB46S 2F CPL COMPLEMENT IT 
SB66 77 Lo (HL)»A sFUT IT BACK 
JR67 BE CF (HL) Phin IT Go? 

9B68 C2 SE7E JP NZ~e JERR 5 NO 

SB6R 2F CPL ORIGINAL BYTE 
SBé6C 77 LD CHLd)sA FFUT IT BACK 


FO 


u827 
S815 


E6 


SPER 


JESA 


El 


3ABO 
SIPEO 


SIAE 


06 


JAAR 
IAOC 
Fi 


JABO 


i9 
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JUST32 LU 


AgvL 7F ASS 
SUB E > COMPLETED? 
Li AvH 
SEC  AeD 
INC HL 
JR Cs JUST2 §NO 
3 
3 AFTER EACH FASS» 
§ SEE IF ABORT WANTED 
3 
CALL INSTAT <INPUT? 
CALL NZvINPUTT $YES>s GET IT 
FOF HL START ADLIR 
FUSH HL s3SAVE AGAIN 
JR JUST2 S5NEXT FASS 
3 
§ FOUND MEMORY ERROR> FRINT FOINTER ANDI 
¢ BIT MAF? O=GOODs 1=BAD BIT 
yp 
JERR? FUSH AF §SAVE COMPLEMENT 
CALL CRHL sFRINT FOINTER 
FOP AF 
XOR CHL) s;SET BAR BITS 
FUSH HL. g9SAVE FOINTER 
a LoA RIT MAP TO L 
CALL BRITS sFPRINT BINARY 
FOP HL. 
JR JUSTS 3 CONTINUE 
3 
§ REPLACE HEX BYTE WITH ANOTHER 
FORMAT IS? START» STOFs ORIG» NEW 
3 
REFL? CALL HLDEBC sRANGEs 15ST BYTE 
JF CryERROR $NO 2ND 
Lo Bel 91ST TO B 
FUSH HL. 
CALL READHL s¢2NI BYTE 
Lo Col 5INTO C 
FOF HL 
REPL2: Lo Avy( HL) $sFETCH BYTE 
CF EB 3A MATCH? 
JR. NZ*REPL3 §NO 
LI (HL) »C sSUBSTITUTE 
LI Ast 
_ CrP CHL) iSAME? 
JF NZvERRB #NO»> BAT 
REPL3: CALL TSTOF 3 TONE? 
JR '  REPL2 
3 
’ GIVE RANGE OF 1ST BLOCK AND START OF SECOND 
3 
VERM3 CALL HLOEBC §3 ADDRESSES 
VERM2: LD Avy (BC) sFETCH BYTE 
CF CHL) 3SAME AS OTHER? 
JR Z»VERMS 5YES 
FUSH HL. #0 IFFERENT 
FUSH RC 
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SBBI CH 
JBE4 4E 
SBBS Cr 
SBRS SE 
SBBA CI 
SBBE E1 
YEBE Cr 
wRC1 4E 
YBC2 CO 
YBCS 4f 
SBC& 44 
JRC? Et 
“BCS Ch 
SRCR OF 
SRCC 18 


Symbols? 


ADIMF 2 
ALOL2 
BRACKUF 
CLATA 
COUT 
CSTAT 
CTRS 
DUMP 2 | 
ERRE 
FILL2 
GETC4 
HHL DE 
IBUFC 
INMSK 
INFLC 
INFUT2 
JERR 
LDATA 
LOADS 
LOUT 
MOVIN 
NF AGE 
OuT2 
OUTCR2 
OUTHX 
FASC2 
ROHL 2 
ROHL IE 
REFL2 
SEARS 
SETLST 
TABLE 
VERM2 


DROL 
SAEY 
0008 
0011 
5806 
0010 
0013 
oPF61 
DA4E 
5A6C 
S9Sct 
SPAS 
S7AS 
O001 
aI29 
IB1A 
SB7E 
0013 
SASL 
S8SB 
SAAS 
SBPA 
S583c 
3876 
IPFS 
II 4 
S9RS 
BPP? 
UBS? 
SABA 
382C 
58C9 
UJEBAB 


VERM33 


<a> 


ADMPS 
AFOS 
RIT2 


START 


ADMF4 
ASCII 
BITS 
CIN 
CRHL 
CTRE 
DEL 
DUMF 4 
ERRP 
FILLA 
GO 
HLDECK 
I BUFF 
INFL3 
INPLI 
INSTAT 
JUST? 
LOAn 
LOADS 
MOVIN 
NIE 

OF ORT 
OuUT4 
OUTHEX 
OUTSP 
FASCI 
RIHLS 
REGS 
RESTRT 
SEARS 
START 
TSTOF 
WARM 


yPRINT 1ST FOINTER 


sFIRST BYTE 
sPRINT IT 


yBesC TO Hel 


sSECONT FOINTER 


g2N0 BYTE 
gFPRINT IT 
gRESTORE C 
sAND B 

sAND Hol 

9 TONE? 

s2ND POINTER 


JBIB ALUMF 
VADS ASCS 
UBSA CALLS 
3809 COLD 
IIES CRLF 
0010 CTRQ 
OO7F BUMP 
SP7S QUMPFS 
JAAA FILL 
SA7A GCHAR 


JAL4 HEX1 

VASE HMATH 
37AS INLN 

U9OLER INFLE 
590A INPLN 
B27 IFORT 
SEGA JUSTS 
vAL? LOAL2 
wA4O LOMSK 


UAIA MOVE 
sPLO NNULS 
5B47 ORGIN 


4851 - OUTCR 
JOFO OUTHL 
vOFS OUTT 


998K FORTN 
v9CH ROHL D2 


SASS REPL 
7803 SEAR2 
vACB SEARCH 
3800 TAB 
TAOC VERM 
9891 ZERO 


SAFE 
5820 
SA1LS 
SB7E 
5935 
0011 
S9SE 
SP7E 
SAb4 
SBOF 
SA01 
SBS 1 
380C 
SOF 
SBFO 
SBS1 
SB60n 
SAIC 
0002 
SAP7 
0004 
3800 
5874 
S9ER 
S835 
37A0 
SP9C 
SESC 
SARO 
SAAT 
0009 
SEAS 


VAST 
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CONVERSION OF THE MONITOR TO Z-80 MNEMONICS 


If you used 8080 mnemonics to program the monitor in Chapter 6, you can 
now convert it to Z-80 mnemonics. The form of the mnemonics depends on 
the type of assembler you have. The Microsoft assembler accepts both the 
Intel 8080 and the Zilog Z-80 mnemonics. Since most other assemblers use 
only one or the other, you may need a second assembler. 

The Digital Research assembler MAC requires the 8080 mnemonics, but 
it can generate Z-80 code with an accompanying macro library. The Xitan 
assembler utilizes 8080 mnemonics for the common set of 8080-type instruc- _ 
tions and Zilog-like instructions for the others. 

First, make a working copy of the monitor using PIP, a CP/M utility 
routine. 


PIF MONZ.ASM=MON17.ASMEVI 


If you are using MAC or the Xitan assembler, skip to the next section. Other- 
wise, use the system editor to make the necessary changes to the new file. 
The conversion can be easily performed with the global substitute command | 
of the Word-Master or the CP/M editor. For example, the 8080 mnemonic 


MOV Asi 


can be changed to the equivalent Z-80 mnemonic 


LD Ar CHL) 


with the command 


KXSMOV<tab>AsMSLD<tab>As (HL) SOTT 


The $ symbols indicate that the escape key is pressed. The “‘tab” refers to 
the ASCII tab key, a control-I. You may find the cross-reference list for 8080 
and Z-80 mnemonics, given in Appendix G, helpful in the conversion process. 

After changing the monitor to Z-80 mnemonics, assemble it and care- 
fully check the assembly listing to see that the hex code is correct. The Z-80 
version at this time should generate the same hex code as the 8080 version. 
A further check can be made with the monitor’s V command. Load the 
binary code into memory with an offset. A command of 


HoT 
IMONZ «HEX 
RFOOO 


will load the new version 4K bytes below the regular monitor position. 
Branch to the monitor prepared in the last chapter. Then compare its code 
to the new version using the verify command. If there is a discrepancy, find — 
the error and correct it. When you are convinced that the Z-80 version pro- 
duces the same code as the 8080 version, you can begin the alterations to 
reduce the monitor’s size. 
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REDUCING THE MONITOR SIZE 


In this.section you will reduce the monitor size by converting many of the 
3-byte absolute jump instructions into 2-byte relative jump instructions. 
This change will make room for additional features. There are five types of 
jumps to be changed. 


absolute relative condition 
Jumr SRO 
JP xX JR X unconditional 
- JSP ZoX JR Z9X ' Fero 
JF NZ» X JR NZ 2X not zero 
JP CX JR CX carry 
JF NC xX JR NC 9X not carry 


Not all of the absolute jumps can be converted in this way since the relative 
jumps are limited to a distance of about 126 bytes. 

Another way to obtain more space is to move some of the subroutines 
to more advantageous locations. This will allow a few more absolute jumps 
to be converted into relative jumps. For example, several routines contain a 
jump to the routine ERROR. These can be placed together in a group. Then 
the ERROR routine can be moved into the middle of the group. 

Another change will free up three more bytes. Notice that subroutine 


~ OUTSP ends with the instruction 


JP OUTT 


If this subroutine were located directly ahead of subroutine OUTT, then the 
jump instruction would not be necessary. Actually, this type of change has © 
already been used extensively in our monitor. Subroutines CRHL, OUTHL, 
OUTHEX, and OUTSP are all directly related. They initially could have been 
programmed (using Z-80 mnemonics) as 


CRHL: CALL CRLF 
, CALL = OQUTHL 


RET 

§ 

OQUTHL: LD. CoH 
CALL OUTHX 

OUTLL? LD Col 
CALL OUTHEX 
RET 


OUTHEX? CALL OUTHX 
CALL OUTSP 


RET 
4 
OUTSP? LD Ar’ / 
CALL OOUTT 
RET 


A Z-80 SYSTEM MONITOR 145 


The CALL/RET combination at the end of each routine can be replaced by 
a JP instruction. Then, since the calling program is located directly above 
the called program, the jump instruction becomes unnecessary. Thus, four 
bytes are saved in each of the first three routines. Furthermore, if this entire 
block of four subroutines were located just prior to subroutine OUTT, we 
could eliminate the final JP OUTT instruction and save three more bytes. 
While this kind of subroutine rearrangement can be used to make the 
overall program smaller, there is a penalty. The readability is reduced. We 
have traded comprehension for space. This may not, in general, be a worth- 
while tradeoff for assembly-language programming. Such programs are more 
difficult to understand than those written in a high-level language such as 
Pascal or BASIC. Furthermore, assembly-language programs are typically 
much shorter than they would be if written in a higher-level language. But if 
packing a maximum number of features into a 1K PROM is your goal, then — 
this technique may be worth it. 


GETTING MORE FREE SPACE 
The two instructions 


GEC KR 
JP NZX 


which generate four bytes of code appear in two places. Beare them with 
the 2-byte instruction 


DINZ X 


One location is just prior to the label. MSIZE (address 58A5 in Listing 7.1) 
and the other is in subroutine BITS (5B38A). This change will free four 
more bytes. 

The 16-bit subtraction routine in HMATH (5B51) has been improved. 
The sequence of instructions 


Lo ArL 
SUE AvE 
LO LeA 
Lo AvH 
Sec Ask 
LO HA 


is replaced by the shorter, double-precision subtraction: 


OR ) Sreset carry 
SEC HL o DE Psubtract 


Three more bytes are freed by this change. 
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-Since the Z-80 contains a set of instructions for direct rotation of data 
in the general CPU registers, we can simplify subroutine BITS. In the 8080 
version, the three instructions 


MOY AvkL 
ADD A 
MOY Lea 


are used to move the data from a general register to the accumulator, perform 
the shift, then move it back. The 2-byte, Z-80 arithmetic shift left instruction 


SLA L 


performs the shift directly in the L register. 

~The 8080 can output a byte only from the accumulator, and can input 
a byte only to the accumulator. Furthermore, the address of the peripheral 
must be located in memory immediately following the first byte of the input 
or output instruction. 

The port-input routine IPORT and the port-output routine OPORT in 
the system monitor utilized subroutine PUTIO. This routine writes the 
desired IN or OUT instruction in memory, the requested port address and 
then a return instruction. There is a Z-80 instruction that can perform I/O 
from any register. The address of the peripheral is located in register C in 
this case. Since the port address does not have to be located in memory, 
subroutine PUTIO can be eliminated. The resulting Z-80 code is 19 bytes 
shorter than the 8080 version. See Listing 7.1 for the new versions of PORT 
(5B381) and OPORT (5B47). 

Since you are nearly finished with the development of the monitor 
program, you can gain some more space by removing the routines that print 
the version number. There are four areas involved. First, delete the line near 
the beginning that identifies the version number. 


VERS EQU ‘i7* 


Second, remove four lines starting with the label SIGNON. Third, delete the 
two lines starting on the line after the label COLD. 


Lo DE»SIGNON 
CALL SENDM 


Fourth, remove the entire subroutine SENDM, but keep a copy of it in case 
you want to incorporate it in another program. 


PERIPHERAL PORT INITIALIZATION 


There are two schools of thought on peripheral port initialization. One 
approach is to initialize ports only on a cold start or a warm start. The other 


A Z-80 SYSTEM MONITOR 147 


way is to initialize a port each time it is used. The method you use depends 
on the integrity of your system. 

The approach taken in this chapter initializes ports only on a cold start. 
The instructions are placed just after the label COLD. In anticipation of — 
adding a printer-output routine, we include the initialization for two sepa- 
rate peripherals. 

Ports which need initialization utilize a control register for this pur- 
pose. The address of the control register is the same as the status register. A 
CPU IN instruction reads the status register, while a CPU OUT instruction 
to the same address writes into the control register. A typical initialization 
procedure requires two OUT instructions. The first is used to reset the port; 
the second is used to set the desired options. The values shown in the listing 
correspond to a Motorola 6850 ACIA serial port set for eight data bits, one 
stop bit, and no interrupts. 


Lo Ars 

OUT (CSTAT) 9A $ RESET 

Lp AviSH 

OUT (CSTAT) 9A > SET FEATURES 


PRINTER OUTPUT ROUTINES 


Up to this point, we have been writing programs for output to a console 
video screen. We output an ASCII backspace character for error correction so 
that the cursor will actually back up on the screen. We also included a pair 
of scroll commands: control-S to freeze the display and control-Q to resume 
the scrolling. 

Sometimes, however, we want computer output we can look at after 
the computer has been shut off. A printer or list device is what we need for 
this purpose. We will not want to use the printer as a main console, though, 
because it is too slow. 

For sophisticated operating systems like CP/M, the software for the list: 
device is wholly separate. For example, we can divert a disk file to the printer 
and none of the system commands will appear on the listing. 

Our approach will be a little different. The video console will always 
display all output whether the printer is on or not. Of course, when the > 
printer is engaged, the console speed will be reduced to that of the printer. 
We will both enable and disable the printer with a control-P command, just 
as in CP/M. We refer to the control-P command as a list toggle: the same 
command turns it on or off. The output includes the eenOIng of the com- 
mands typed in from the console keyboard. 

Both the input and output routines will have to be changed if you want 
to incorporate the printer routines. In addition, two new subroutines will 
be added. First, add two new lines to the input routine; they will look fora 
control-P from the console keyboard. If a control-P is found, the program 
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will branch to a new subroutine called SETLST. The two new lines appear in 
subroutine INPUTT (5815). 


CP CTRP gAP 
JR ZeSETLST sLIStT 


Subroutine SETLST (582C), containing 4 lines of code, is added just 
after subroutine INSTAT. 


SETLST?: LO Avy (PORTN) §¢CHECK FLAG 
CRE § INVERT 
Lo (PORTN) 9A §SSAVE 
JR INFUTT gNEXT RYTE 


This routine complements the printer flag (PORTN) when a control-P is 
typed. The output routine uses this flag to determine whether to send out- 
put to the printer. Notice that in Chapter 6, the identifier PORTN was used 
to set up the port number for the I and O commands. This feature is not 
- needed for the Z-80 version, so we can use the location for the printer flag 
‘instead. — 

The third new section is placed in the output routine OUTT (5835). 


Lo Avy(FORTN) SWHERE? 


OR A 9 ZERO? 
JR NZ» LOUT sLIST OUTFUT 


This part checks the flag PORTN to see if output is to be sent to the printer. 

The fourth routine is LOUT (585B); it follows OUT4. This routine 
sends output to both the console and the printer. It first checks the status 
port for the printer. When the output bit indicates ready, a byte is sent to 
the printer. Since the console video screen operates so much faster than the 
printer, there is no need to check the console-ready flag. The byte is there- 
fore also sent directly to the console by the next instruction. The output 
appears simultaneously at both devices. 


DELAY AFTER A CARRIAGE RETURN 


Video screens operate with electron beams that move very fast. Mechanical 
printers, on the other hand, are much slower. For some printers, the time it 
takes to execute a carriage return is so great that the first few characters of 
the next line may be lost. The solution is to have the computer do something 
else for a little while after it sends a carriage return. 

One method of slowing down the computer is to arrange for it to send 
binary zeros, called nulls, after each carriage return or carriage-return /line- 
feed pair. One routine for accomplishing this is as follows. 
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CRLF? Lo AryCR sCARRIAGE RET 

CALL OUTT §SEND 

LIt AsLF SLINE FEED 
CALL OUTT §SEND 

XOR rs) §GET A NULL 
CALL OUTT sSEND. IT 

CALL OUTT 9A SECOND ONE 
CALL OUTT sA THIRD 

JF OUTT §THE FOURTH 


But this approach may cause trouble if the printer circuits attempt to inter- 
pret the null characters. 

A different approach is taken with the list-output routine, LOUT, 
shown in Listing 7.1. After each carriage return is sent, the computer starts 
executing a double loop. The inner loop is executed 250 times. The outer 
loop is set according to the equivalent number of nulls that are needed. No 
nulls are actually sent, though, in this case. 

The disadvantage of this method is that the resultant delay time is a 
function of the computer speed. A Z-80 running at 4 MHz would require 
approximately twice the number of loops as would a 2-MHz Z-80. Thus, the 
loop-initialization values may have to be adjusted to the particular computer. 

Be careful to tailor the port-initialization routines to your system or 
remove them if they are not needed. The time delay in the list-output rou- 
tine should also be removed if it is not needed. If you are not sure whether 
a delay is necessary, then leave it in, at least for the first version. Then use 
the memory load command of the monitor itself to reduce the delay values 
on the two loops. When you reduce the delay time to too small a value, then 
you will notice that some of the characters are missing from the beginning of 
some of the lines. 

A sample loop-change session could look like this. 


703870 S87F 

9870 C0ODS1678 1EFAID20 1520... . 
*LS873 

$873 « 78 3C 

5873 . 1E AX (to eauit) 


The first command line is used to display the memory region containing the 
loop constants. Then the outer loop value of 78 hex is changed to 8C hex 
which is half the value. As long as you change the timing-loop values with 
the printer disengaged, no problem should occur. After each change in the 
timing loops, re-engage the printer with a control-P. Display several lines on 
the printer by giving the D command. Check to see if any of the first few 
characters of each line are missing. If everything is all right, then again 
reduce the loop constant until characters are lost. (Be sure to disengage the 
printer between each change.) 


CHAPTER EIGHT 


Number-Base Conversion 


This chapter deals with assembly language routines that can be used to 
convert data from one form to another. The first part deals with the conver- 
sion of a sequence of ASCII characters called a string into a binary number. 
The second part reverses the procedure; binary numbers are converted into 
_ ASCII strings. The characters in each string represent digits in one of the 
common bases 2, 8, 10, or 16. The corresponding binary number may be 
4A bits, 8 bits, or 16 bits in size. 

. All of the programs in this chapter are designed to run with the system 
monitor developed in Chapters 6 and 7. Some of the monitor’s input and 
output facilities are needed. These include the console input buffer which 
supplies the characters, the binary-to-hexadecimal conversion routine which 
will print the answer in hexadecimal, and the console output routine needed 
for the error message. 

The monitor error-correction features are available during input. Press- 
ing the DEL (or RUB) key or the backspace (control-H) key will delete the 
previously typed character and remove it from the console video screen. If 
the list routines have been incorporated into the monitor, the printer can be 
turned on by typing a control-P. When you have finished with each routine, 
you can return to the monitor simply by typing a control-X. 


THE ASCII CODE 


When a key is pressed on a computer terminal, a unique signal is sent to the 
computer. There are several, very different ways of electronically encoding 
this signal. ASCII, which stands for American Standard Code for Informa- 
tion Interchange, is the most commonly used code. Appendix A gives the 
128 ASCII characters with the corresponding values expressed in decimal, 
hexadecimal, octal, and binary. EBCDIC, which is used by IBM, is another 
coding technique. 
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The ASCII table can be divided into four parts. Part 1 of the table 
contains the nonprinting control characters. Part 2 contains most of the 
special characters such as $, %, and #, and the digits 0-9. The uppercase 
letters are found in part 3, and the lowercase letters are found in part 4. 

Computer terminals typically have a keyboard that looks like a type- 
writer. There is a shift key to change from lowercase letters to uppercase 
letters. In addition to the shift key, there will usually be a control key. This 
key will give the letter keys a third meaning. Thus the user can enter a 
lowercase letter A, an uppercase letter A (a shift A), or a control-A. The bit 
patterns are: 


110 0001 lowercase A 
100 0001 uppercase A 
000 0001 control-A 


It can be seen from the pattern that the shift key resets bit 5 while the con- 
trol key resets both bits 5 and 6. 

Some of the commonly used control functions such as the carriage : 
return (control-M), line feed (control-J), the horizontal tab (control-I), and 7 
the backspace (control-H) may have their own separate keys. 

All console input to the computer will be in the form of ASCII char- 
acters. The console will send eight data bits for each character. But the 
ASCII code contains only seven bits per character. Consequently, the eighth, 
high-order bit is not needed. The user will need to have routines for convert- 
ing strings of ASCII characters into the ultimate numbers that will reside in. 
memory. For example, if the operator enters the string 


3014 
from the console, the computer would actually receive the bit patterns 


011 0111 (ASCII 3) 
011 0000 (ASCII 0) 
011 0001 (ASCII 1) 
011 0100 (ASCII 4) 


The next step is to convert the string into a 16-bit number. The conversion 
scheme that is chosen depends on whether the string represents a decimal 
number, an octal number, or a hexadecimal number. 

Additionally, a check is made to ensure that each character in the string 
is within the proper range. For example, octal numbers must contain only 
the digits zero through 7. The digits 8 and 9, the letters A through Z, and the 
other characters are not used. Finally, we may need a special character, 
called a delimiter, to indicate the end of a string. We will use a space or a 
carriage return for this purpose. Thus the string of characters 


1034 2347 


152... 8080/Z-80 ASSEMBLY LANGUAGE 


will be interpreted as two separate numbers since a space appears in the 
middle. . 

- The ASCII string may need to be converted into a 4-bit nibble, an 8-bit 
byte destined for a CPU register, or a 16-bit word meant for a double register. 
_ Furthermore, the format may be either free entry or fixed entry. The choice 
is a matter of personal taste. With free entry, leading zeros are not needed. 
The entries 


0004 
004 
04 

4 


are all interpreted as the same number. An additional feature is that you can 
recover from an error by retyping the entry on the same line. Suppose that 
the 4-digit number 1035 is desired but 1045 was typed by mistake. The 
correct value can be immediately typed without a space. 


10351045 
If two 4-digit numbers are needed, they must be separated by a delimiter. 
1045 1055 
With the fixed-entry format, the required number of digits, including leading 
zeros, must be entered. But since an end-of-string indicator is not needed, 
two numbers can be run together. The fixed-entry expression 


10451055 


will be interpreted as two separate numbers. 


CONVERSION OF ASCII-ENCODED BINARY CHARACTERS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 


One of the simplest base-conversion routines is the ASCII-to-binary pro- 
gram. This program takes a string of ASCII-encoded ones and zeros from the 
console input buffer and produces an 8-bit binary number in register C. The 
hexadecimal equivalent of the number is printed on the console. If the 
operator types the string 


10101100 


the keyboard actually transmits the following sequence. 
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011 0001 
011 0000 
011 0001 
011 0000 
011 0001 
011 0001 
011 0000 
011 0000 


The conversion routine will take this combination, convert it to the binary 
number 


10101100 


and place it into the C register. 

Type the routine shown in Listing 8.1 Set the assembly (oeation some- 
where below the monitor’s stack and include the address of the monitor 
using the EQU directive. The monitor I/O routines are defined relative to 
the monitor’s address. 


Listing 8.1. ASCII-encoded binary to binary in C. 


THIS PROGRAM IS DESIGNED TO OPERATE 
WITH THE SYSTEM MONITOR AT S800 HEX. 


a 
9 
4 
¥ 
a 
9 
* 
9 
4 


JAN 299 BO 
¥ 
JO00 ORG OOOH 
g 
3800 = MONIT EQU 3800H 
u806 = OUTT EQU MONIT+64 
JBOC = INFLN EQU MONIT+0CH 
SBOF = GETCH EQU MONIT+tOFH 
vB1l2 = OUTHX EQU MONIT+12H 
3 
9000 SEOD START? MMVI Av ODH sCARR RET 
YO02 ClOé6é58 CALL OUTT 
9005 3EOA MVI Av OAH gLINE FEED 
83007 ChOé6S8 CALL OUTT 
VOOA CHOCSS CALL INFLWN gGET A LINE 
YOON ChiBSO CALL BRIN § CONVERT 
9010 CD1258 CALL OUTHX yHEX VALUE 
YO13 SE20 NVI Ay’ ¢ 
VOLS ChOé6S8 CALL OUTT 
¥ 
§ THE NEXT INSTRUCTION IS NEEDED WHEN 
§ THE ROUTINE IN LISTING 8.9 IS AFPENTIED 
3 CALL BITS *RIN TO ASCII 
9018 C30050 JMF START gNEXT VALUE © 


SUBROUTINE TO CONVERT UF TO 8 ASCII- 
ENCONED BINARY CHARACTERS INTO AN 
8-BIT BINARY NUMBER IN C 


“Sp “Gh NI> “SIP “GP 
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SO1R ES ERIN? FUSH H §SAVE REGS 
501C 210000 LXI HO sCLEAR 

SO1F CLOFSS RRINZ! CALL GETCH $GET CHAR 

5022 LAZSASO Jc REINS $LINE END 

5025 630 SUI ‘QO? SCONV TO BINARY 
5027 DA3S50 Jc REINA $< 0 

HO2A FEO2 CFI 2 

SO02C N23050 , JNC ERROR 4 

SO2F 2 DAL H $SHIFT LEFT 
5030 BS ORA L. ALL NEW CHAR 
5031 6F MOV LeA 


9032 C31LF50 JMF BBIN2 §NEXT 


CHECK FOR BLANK AT END 


“S> “Gr “ae 


S035 FEFO RBIN4: CFI Cf 7-0") AND OFFH 
9037 C23050 JNZ ERROR sNOT BLANK 
VOSA 41 BBIN3: MOV Crk ’8 BITS TOC 
JOSR El FOF H gRESTORE 
wO3C C9 RET 


PRINT ? ON IMPROPER INFUT 


$030 Ci RROR? FOF B sRAISE STACK 
SOSE Ci FOF B 

YOSF SESF MVI Ay’?! 

O41 CHO658 CALL OUTT 

3044 C30050 JMF START 9TRY AGAIN 


Assemble the program and load it into memory; start it up by branch- 
ing to the beginning of the program, the address of START. The monitor 
prompt symbol of > will appear on the console. Test the routine by entering 
the following binary numbers. Be sure to add a carriage return to the end of 
each line. 


>O (you type this) 
00 (Program resronds with this) 


02 (binary 10 is hexadecimal 2) 


O05 (binary 101 is hexadecimal 5) 
>iili 
OF 
211110000 
FO 
710101010 
. AA 


Of course, only ASCII zeros and ones are acceptable binary characters. 
Leading zeros are not necessary. If more than eight characters are entered, 
only the last eight are used. A question mark will be printed if a nonbinary 
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character is typed. Typing errors can be corrected with a backspace or 
DEL keys. 

The program consists of three parts. The first and third parts will be 
common to other conversion programs in this chapter. The first part calls 
the monitor to obtain data from the console. The last part converts the data 
to the hexadecimal equivalent and prints it on the console if valid. If the 
entry is invalid, a question mark is printed. 

The conversion routine occupies the middle portion of the program. It 
works as follows: Since HL is used as a working register, the original con- 
tents are first saved on the stack. While this step is not necessary in this case, 
it may be needed in a real application. The HL register is then zeroed. 

As each new character is obtained from the input buffer, it is converted 
from ASCII to binary by subtracting 30 hex, the value of the ASCII zero. 
An ASCII zero, which has a value 30 hex, becomes a binary zero. Similarly, 
an ASCII 1, which has a value of 31 hex, becomes a binary 1. 


O11 0000 ASCII zero 
611 0000 subtract ASCII zero 


000 0000 binary zero 


O11 0001 ASCII 1 
O11 6000 subtract ASCII zero 


sae wine tae em vee tune bees enee 


000 OOO1 binary 1 


A check is made at this point to ensure that an invalid character has not 
been typed. Only three characters are acceptable: An ASCII zero, an ASCII 
1, and a space. If the carry flag is set after the subtraction of an ASCII zero, 
then the input value was neither a zero nor a 1. But it might be a space 
character. A jump is made to subroutine BBIN4 in this case. This routine 
determines whether the current character is a space or some other character. 
A space is the normal end-of-string character (delimiter); other characters 
are not. 

Each character is also checked to see that it is not greater than an 
ASCII 1. In either case, if any character in the string is found to be other 
than an ASCII zero or 1, then the subroutine is terminated with a jump to 
the error routine. At this point, the stack is raised with a POP instruction, 
and control returns to START at the top of the program. 

If the input value is a zero or 1, the procedure continues. The current 
value in the HL register is multiplied by two, the binary number base. This 
arithmetic shift left is accomplished by adding the HL register to itself with 
the double-precision add DAD H. An alternate method would be to place 


the sum in the accumulator. In this case the multiplication is performed with ._ 


an ADD A instruction. But then the intermediate sum would have to be 
saved in another register while the new character was checked. 

The new character, which is now a binary zero or 1 in the accumulator, 
is added to the value in HL. The addition of the 8-bit accumulator to the 
16-bit HL register generally requires several steps. 
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1. Add Lto A. 
2. Move sum in A to L. 
3. Increment H if carry is set. 


But in this particular case, the carry flag will never be set. Consequently, a 
simpler method of addition can be used. The one chosen for this application 
is to perform a logical OR operation with the L register and the accumulator. 


CONVERSION OF ASCIT DECIMAL CHARACTERS 
TO A BINARY NUMBER 


We frequently find it useful to input computer data in the form of decimal 
numbers. We may then need a program to convert ASCII-encoded decimal 
numbers into binary form. The program given in Listing 8.2 will perform 
this task for us. 


Listings 8.2. ASCII decimal to binary in HL. 


THIS FROGRAM IS DESIGNED TO OFERATE 
WITH THE SYSTEM MONITOR AT S800 HEX 


* 
9 
a 
9 
* 
7 
“ 
¥ 
a 
? 


JAN 22% 80 
3000 ORG OOOH 
¥ 
7800 = MONIT EQU J800H 
3BOG = OUTT EQU MONIT+S 
y80C = INFLN EQU MONIT+OCH 
J80F = GETCH EQU MONIT+OFH 
S812 = OUTHX EQU MONIT+12H 
# 
3000 SEOL STARTS MMVI A» OLH sCARR RET 
3002 CH0658 CALL OUTT 
9005 3SEOA MVI Av OAH sLINE FEED 
J007 ChO6S8 — CALL OUTT 
JOOA CHOCSS CALL INFLN 9GET A LINE 
9000 Cn2050 CALL DBIN yASCIT TO DEC 
5010 4C MOV CyH jHIGH HALF 
S011 ChL258 CALL OQUTHX 
5014 4f MOV Crk 
VOLS CH1L258 CALL OUTHX sLOW HALF 
8018 3SE20 MVI Ay’ ¢ i SPACE 
YOLA CU0658 CALL OUTT 
: ¥ 
§ THE NEXT INSTRUCTION IS NEEDED WHEN 
§ THE ROUTINE IN LISTING 8.11 IS USED 
3 CALL BINT! 9RIN/DECIMAL 
YOIL C30050 JMF START gNEXT VALUE 
¥ 
§’ ASCIT DECIMAL TO 16-BIT IN Hel. 
P 
9020 DS BIN? FUSH i *SAVE REGS 
9021 210000 LXxI H»O gCLEAR 


TERIA COASTS TAH RSNA Serr SSSA nA ASPERGER Eh TTS 


5024 
5027 
SOLA 
502C 
3O2F 
O31 
5034 
5035 
5036 
5037 
5038 
5039 
SOSA 
5038 
3030 
SO3E 


9041 
7043 
OAS 
3047 


9048 
v049 
JO4A 
JO4aC 
DO4F 


CHOFSS TRIN: 
TA4650 

0430 

LA4150 

FEOA 

hH24850 


19 
C32450 


FEFO DURING ¢ 
C24850 

tel DBINS: 
Cc? 


FRINT 


El 

El 
SESF 
ChO4é58 
C 30050 


RROR ¢ 


. FOR 


CFI 
JNZ 
POF 
RET 


NUMBER-BASE CONVERSION 


GETCH 
DNBINS 
“O° 
DBINA 
10 
ERROR 


BLANK AT ENT 


*GET CHAR 

sLINE END 

sCONV TO BINARY 
5 = 0 


§ = 10 
gCOFPY Hel 
5 INTO DsE 
§TIMES 2 
sTIMES 4 
®TIMES 3 
§TIMES 10 
sNEW BYTE 


sALD NEW BYTE 
¢NEXT 


(4 *~/0O°) AND OFFH 


ERROR 
f) 


sNOT BLANK 
sRESTORE 


? ON IMPROPER INFUT 


FOF 
FOF 
MVI 
CALL 
JMP 


H 
H 
Ar’ ?’ 
OUTT 
START 


PRESTORE 
gSTACK 


gTRY AGAIN 


157 


This new program uses our monitor for some of the necessary sub- 
routines, just like the ASCII binary-to-binary program given in the previous 
section. Assemble the program, load it into memory, and branch to START. 
Again, the monitor prompt symbol > will appear. Try this routine by 
entering the following decimal numbers. Remember to type a carriage 
return at the end of each line. 


(you tyre this) 


(computer resronse?) 


(decimal 10) 
(stives OA hex) 
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If the input consists of valid decimal characters, then the response will be 
the corresponding hexadecimal value. If an invalid character is typed, a 
question mark is printed as an error message and the program is restarted. 

Since this routine generates a 16-bit binary number, the largest possible 
value is one less than 2 to the power 16. This is equivalent to a decimal 
‘number of 65,545. If a larger number than this is entered, the excess over 
65,545 is lost. Thus, an input of 65547 will give a value of 0002. Remember 
that the monitor error-correction features and the control-P list toggle are 
available. 

The algorithm is similar to the one in the previous section. The HL 
register pair is initially zeroed. The incoming character is converted from 
ASCII to binary, then checked to see that it is in the range 0-9. The current 
value is multiplied by 10 (the number base) prior to adding in the new 
character. The multiplication is accomplished with the double-register add 
instructions as follows. 


MOV DeH (durlicate H im BD) 

MOV Evel (durlicate E in LL) 

DAD H (double initial value) 

DAL H (auadruple it) 

DAL i] (35 times initial value) 

nal H (doubles making 10 times 
the initial value) 


The total is first duplicated in the DE register. Two double-precision DAD H 
operations multiply the original value by 4. Adding in the original value with 
the DAD D makes it 5. A final DAD H produces the desired multiplication 
by 10. 

If only an 8-bit binary number is needed, then the multiplication can 
be performed in the accumulator rather than in the HL register. This will 
free the HL register for some other use, such as a memory pointer. The 8-bit 
version is given in Listing 8.3 


Listing 8.3. ASCII decimal to binary in C 


THIS PROGRAM IS DESIGNED TO OFERATE 
WITH THE SYSTEM MONITOR AT 5800 HEX 


« 
# 
a 
¥ 
4 
# 
a 
y 
a 


JAN 12% 80 

¥ 
3000 ORG OOOH 

Z 
53800 = MONIT EQU 3B00H 
3806 = OUTT EQU MONIT+6 
380C = INPLN EQU MONITtOCH 
SBOF = GETCH EQU MONIT+0OFH 
YB12 = OUTHX EQU MONIT+12H 

9 
9000 SEOD START: MMVI Ay ODH gCARR RET 
9002 Ch0658 CALL OUTT 
9005 3EOA NVI Ay OAH gLINE FEED 
9007 ChO658 CALL OUTT 


Sennen mem men ennemaemnmen tne emmmenen inrnmenenmnennna nae TNH SOR NO EC To Eee E 


NUMBER-BASE CONVERSION — 159 


300A CHOCSS CALL INF LN sGET A LINE 
OOD Ch1650 CALL DBIN snEC TO BIN 
93010 Chi2ss CALL QUTHX §HEX 

9013 C30050 JMF START 


CONVERT ASCII-~DECIMAL TO 8-BIT BINARY 


“Gb “Or “ED 


3016 OEO0O DBING MVI C0 gCLEAR C 
3018 CHOFSS DRIN2: CALL GETCH §GET CHAR 
JO1B LS RC gLINE END! 
SO1C 1630 SUT “O°% sCONV TO BINARY | 
SOLE TAS250 JC DRINA ; = 0 

S021 FEOA CFI 10 

53023 N23850 JNC ERROR § * 10 
3026 37 MOV liv A *SAVE NEW 
O27 79 MOV Ag 9SUM 

9028 87 ALT A ¢TIMES 2 
3029 AF MOV CrA 9 SAVE 

502A 87 ADD A sTIMES 4 
SO2BR 87 Ah A sTIMES 8 
sO2C 81 ALL Cc #TIMES 10 
502k! 82 ADT 0 # COMBINE 
JO2ZE 4F MOV CrA §SAVE IN C 
9O2F C31B50 JMF IBIN2 sNEXT 


CHECK FOR BLANK AT END 


a 
¥ 
a 
7 


5032 FEFO INERIN@? CFI (7 7=/07) AND OFFH 
5034 C23850 JINZ ERROR  #NOT BLANK 
5037 C9 RET 
} PRINT ? ON IMPROPER INFUT 
; 
5038 Fl ERROR? FOF FSW }RESTORE 
5039 3E3F MI Ar’?! 
503B ChO658 CALL OUTT 
SOZE C30050 JMP START  $TRY AGAIN 
; 
5041 ENW 


CONVERSION OF ASCII HEXADECIMAL CHARACTERS 
TO A 16-BIT BINARY NUMBER IN HL 


The development of a routine to convert a string of ASCII-encoded hexa- 
decimal characters into a 16-bit binary number will now be considered. This 
is the routine most frequently used in a system monitor. In fact, this was one 
of the first routines to be incorporated into our system monitor. Somewhere 
along the way there will have to be a multiplication by 16, since this is the 
base of the hexadecimal number. The multiplication can be easily performed 
by shifting the results left by four bits. Shifting left one bit is equivalent to 
multiplying by 2. Consequently, shifting by two bits performs a multiplica- 
tion by 4. 

For the binary routine we considered first, only the characters 1 and 
zero were valid. In the decimal routine that followed, the range of valid 
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input was zero to 9. The hexadecimal routine we will now consider is com- 
plicated by the fact that both the digits 0-9 and the letters A-F are valid. 
Two separate algorithms will be considered; one produces an 8-bit 
_ result, the other gives a 16-bit result. The program given in Listing 8.4 is 
‘similar to the previous ones. It will convert a string of ASCII-encoded hex 
characters into a 16-bit binary number in the H,L register pair. The double- 
precision add, DAD H, is used four times to perform the multiplication 
by 16. 


Listing 8.4. ASCII hex to binary im HL. 


THIS FROGRAM IS DESIGNED TO OFERATE 
WITH THE SYSTEM MONITOR AT S800 HEX 


GQ> “Gp “Ze “ar ‘Gp 


JAN 18% 80 
9000 ORG JO0O0H 
? 
3800 = MONIT EQU ~800H 
5806 = OUTT EQU MONTT+4 
s80C = INPLN EQU MONIT+0OCH 
S80F = GETCH EQU MONIT+OFH 
vB1l2 = OUTHX EQU MONIT+12H 
9 
O00 SEOD START? MVI Ay OLH gCARR RET 
8002 ChOé653 CALL OUTT | 
3005 SEOA MVI Av OAH gLINE FEED 
3007 CHOSSS8 CALL OUTT | 
SO0A CHOCSS CALL INFLN *GET A LINE 
JOOD Cr2150 CALL READHL  §s CONVERT 
7010 4C MOV CyH 
~O1l1l Chi258 CALL OUTHX jHIGH HALF 
S014 40 MOV Cel 
VOLS Chi2s8 CALL OUTHX sLOW HALF 
YO18 SE20 MVI Ay’ % 9 SPACE 
SOLA ChO658 CALL OUTT 
sOLnK 7C MOV AvH ¢HIGH BYTE 
? 
§ THE NEXT INSTRUCTION IS NEEDED 
§ WHEN LISTING 8.10 IS APPENDED 
3 CALL. ECS ¢H IN DECIMAL 
SOLE C30050 JMF START gNEXT VALUE 
3 
* READ UP TO 4 ASCII HEX TIGITS FROM 
¥ CONSOLE AND CONVERT TO 16-BIT 
* BINARY NUMBER IN Hel 
? 
8021 210000 READHL$ LXI Hs gCLEAR 
9024 CHOFSS8 ROHL23 CALL GETCH ‘GET CHAR 
9027 [8 RC *LINE END 
9028 CI3ESO CALL NIE §TO BINARY 
SJO2EB DAS750 JC ROHL A yNOT HEX 
NORE 29 DAg H ?TIMES 2 
SJO2F 29 DAL H yTIMES 4 
9030 29 DAL H ‘TIMES 8 
JO31 29 nAn H #TIMES 164 


ALTERNET A Shen nent enn amhnnstirere rte rshshneemenmnenamastnnantsemmsemusiusssasineree 


JO32 
3033 
30354 


3037 
9039 
SOSA 
JOSE 


JOSE 
3040 
9041 
9043 
n044 
wO4S 
3047 
3048 
sO4aP? 
wO4E 


vO4ac 
SO4E 
JOS] 


Each 


mark. 


RS 
é6F 
C32450 


3E3F 
ChO6s8 
C30050 


§ CHECK 


3 
ROHL 4 ¢ 


IR: 


3 
9 PRINT 
3 


NUMBER-BASE CONVERSION 


ORA ok gNEW CHAR. 
MOV LoyAéA 

AMF ROHL 2 #NEXT 

FOR BLANK AT END 

CFI (/ ¢=/0%) ANT OFFH 
RNZ 

BOF H SRATSE STACK 


JMF ERROR 


CONVERT ASCIL CHARACTERS TO BINARY 


SUI QO’ sASCIT BIAS 
RC yO 

CFI SE Ce OE 

CMC ? INVERT 

RC SERROR: > F 
CFI 10 

CMC 9 INVERT 

RNC ‘ sNUMBER 0-9 
SUI “ALTHO m1 
RET gLETTER A-F 


? ON IMFROFER INFUT 


MVI Ay??? 
CALL OuUTT 
JMF START sTRY AGAIN 


161 


ASCII character is converted to binary in subroutine NIB. This 
routine subtracts an ASCII zero, then checks to see that the character is 
valid. If it was originally in the range of an ASCII zero to ASCII 9, it will 
now be converted to the binary number 0-9. If a hex character A-F was 
entered, it will be converted to binary form by the additional subtraction of 
7. Of course, nonhex characters will produce the error message of a question 


Assemble the program, load it into memory, and start it up. Type the 
following series of hex numbers. . 


m4 
0001 
>10 
0010 
>A 
000A 
>FFFF 
FFFF 
>1234 
2345 


3 


Conly last 4 characters used) 


As with the other programs, leading zeros are not needed. If more than four 
characters are input, only the last four are used. Return to the monitor with 
a control-X. 
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CONVERSION OF TWO ASCII HEXADECIMAL CHARACTERS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 


In the previous section, HL was used to convert hex characters into a binary 


number. But, if the HL register pair is needed as a memory pointer, then the 


accumulator can be used for this conversion. In this case, however, only an 


8-bit binary number is produced. Listing 8.5 gives this version. Since the 
routine uses a fixed format, exactly two characters must be typed. This 


means that leading zeros must be entered. 


Listing 8.5. ASCII hex to 8-bit binary C. 


i 
ire) 
oC 
os 
Hou nou 


3000 JEOD 

7002 ChO0658 
3005 3EOA 

3007 CD0658 
500A CBOCSS 
S00D CD1650 
9010 CDB4350 
9013 C30050 


97016 CD2450 
9019 87 


9024 CHROFSS 


§ THIS PROGRAM IS DESIGNED TO OPERATE 
WITH THE SYSTEM MONITOR AT 5800 HEX 


5 
3 
5 JAN 22° 80 
$ 


ORG S000H 

5 

MONIT EQU JB00H 

OUTT EQU MONIT+6 

INFLN EQU MONIT+0CH 

GETCH EQU MONIT+OFH 

é 

§ REMOVE NEXT LINE WHEN LISTING 8.12 ADDED 

sOUTHX ERQU MONIT+12H 

5 

START? MMVI Av ODH sCARR RET 
CALL OUTT 
MVI Av OAH sLINE FEED 


CALL OUTT 

CALL INPLN sGET A LINE 
CALL RDHEX sASCII TO HEX 
CALL OUTHX s;BIN TO HEX 
JNP START 


CONVERT 2 ASCII-HEX CHARACTERS TO 
AN 8-BIT BINARY NUMBER IN C 


Al > Gs ap ‘ar 


DHEX: CALL HEX2 gLEFT CHAR 


ADD a sTIMES 2 
ADD A sTIMES 4 
ADD a sTIMES 8 
ALD a sTIMES 14 
MOV CrA ’ SAVE 

CALL HEX2 *RIGHT CHAR 
ORA c > COMBINE 
MOV CoA 

RET 


CALL GETCH §HEX CHAR 


CONVERT ASCII CHARACTERS TO BINARY 


Se ap sop “ET ep 
my 
4 
ise 
o 


NUMBER-BASE CONVERSION 163 


3027 [1630 SUI °Q’ sASCII BIAS 
3029 TASPSO JC ERROR > «= O 

902C FE17 CFI Ee Qe 

SOZE N23950 INC ERROR ERROR: > F 
3031 FEOA CFI 10 

8033 08 RC yNUMBER 0-9 
3034 D607 SUI ss ilo ie aay | 

3036 FEOA CPI 10 

3038 0 RNC sLETTER A-F 


FRINT ? ON IMPROPER INPUT 


fT] ~> «> ~w> 


3039 Fi RROR: FOP FSW §RAISE STACK 
JO3SA Fi FOP FSW 

SJO3B 3E3F MVI Ay’? 

YO3D CDO4658 CALL OUTT 


9040 C30050 JMF START yTRY AGAIN 


The multiplication by 16 is performed in the accumulator by using four 
ADD A instructions. The ADD A instruction is equivalent to an arithmetic 
shift left. Data is moved from the lower four bits to the upper four, and fills 
the lower bits with zero. 

Assemble the program shown in the listing, load it into memory, and 
try it out. Remember, for this version, exactly two hex characters must be 
entered. 


=QO1 
Ol 
¥10 
10 
>O0A 
oA 
Pie 
12 


If everything is all right, return to the monitor with a control-X. 


CONVERSION OF ASCII OCTAL CHARACTERS 
TO A 16-BIT BINARY NUMBER IN REGISTER HL 


We did not use octal operations in the system monitor developed in Chapter 
6, yet they can be very useful in trying to understand 8080 assembly lan- 
guage instructions. From the 8080 instruction set in Appendix D, it can be 
seen that the registers are assigned values as shown in the following table. 
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slennnensenee nner enmnennninneiemmneee nen 


register value 


emory 


AIO PwNnNe © 
>Re mmD Ow 


Thus the register-move operations are obvious from the octal representation, 
but not from the hex or decimal form. 


octal hex decimal oreration 
101 4i 65 MOV Bel 
123 ba 83 MOV [tee 
1467 77 119 MOV MeA 


While octal numbers appear to be better than hexadecimal for express- 
ing the 8080 operation codes, they leave something to be desired as memory 
pointers. The problem is that 16-bit addresses must be considered as two 
8-bit bytes. But octal numbers represent groupings of three bits, and 8 is not 
evenly divisible by 3. An address of FFFF hex is equivalent to 177777 octal. 
But if this address is stored in two consecutive bytes, each byte will contain 
FF hex or 877 octal. This peculiarity of octal has given rise to the expres- 
sion “‘crazy octal.” A value of FFFF hex is 377:377 crazy octal. 


hex octal crazy octal’ 
FF 377 0003377 
FFF 7777 = OLPF 3377 
7FFF 77777 = 1773377 


FFFF 177777? = 377%377 


Assemble the program, load it into memory, and try it out. The octal 
numbers input to this routine can be in the range of 0 to 177777. Try 
various octal numbers. 


72123456 

A72E 

7200000 (toa big) 
0000 


A ratte 


‘NUMBER-BASE CONVERSION 165 


Listing 8.6 ASCII octal to binary in HL. 


THIS FROGRAM IS DESIGNED TO OPERATE 
WITH THE SYSTEM MONITOR AT S800 HEX 


JAN 22979 

3000 ORG 3000H 

g 
3800 = MONIT EQU 3800H 
9806 = OUTT EQU MONIT+S 
380C = INPLN EQU MONIT+OCH 
SB0F = GETCH EQU MONIT+OFH 
9812 = OUTHX EQU MONIT+12H 

? ‘ 
5000 3EOD START? WMVI As OLH sCARR RET 
3002 Ch0458 CALL OUTT 
S005 JEOA MVI Ay OAH #LINE FEED 
3007 CH0658 CALL OUTT 
300A ChOCSB CALL INFLN #GET A LINE 
S00n CD2050 CALL ROOCT s;0CT TO BIN 
3010 4C MOV CsH $HIGH HALF 
3011 C0hi258 CALL OUTHX 3 BIN-HEX 
53014 40 MOV Csb #LOW HALF 
S015 Chi258 CALL OUTHX 3’ RIN-HEX 
5018 3E20 NVI Ay’ ¢ 9 SFACE 
501A CDO658 CALL OUTT 

? 

$ THE NEXT INSTRUCTION IS NEEDED WHEN 

$ THE ROUTINE IN LISTING 8.13 IS USED 

3 CALL OUTOCT sBIN-OCT 
301D C30050 JMF START §NEXT VALUE 

9 

§ INFUT Hel FROM CONSOLE 

g 
8020 DS REOCT: FUSH n §SAVE REGS 
3021 210000 LXI HO sCLEAR 
5024 CHOFSS OBIN2: CALL GETCH 3GET CHAR 
5027 DA4350 Jc OBING sLINE END 
S02A D&30 SUI °Q’ 3TO BINARY 
SO2C DASESO JC OBRING 3 2 0 
SO2F FEOB CFI 8 
9031 024550 JNC ERROR 3 > 8 
3034 29 NAL H $TIMES 2 
53035 29 DAL H $TIMES 4 
93036 29 DAL H sTIMES 8 
3037 SF MOV EvA sNEW BYTE 
53038 1400 MVI yO ; 
303A 19 DAD i SAND NEW BYTE 
SO03B €32450 JMP ORIN2 §NEXT 

, ? 

§ CHECK FOR BLANK AT END 

F 
JOSE FEFO OBIN4S? CFI (4 ¢=/07) ANID OFFH 
3040 C24550 JNZ ERROR sNOT BLANK 
3043 D1 OBIN3? FOF D #RESTORE 


3044 C9 RET 


rs 
y 


en nnn ne ne TO nna rane annmmnirnmmeneniem nena eemenuendaotianenenianeemeneeeeeieemaneeelnenenennnn na 
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a ene nce ee 


¢ FRINT ? ON IMPROPER INFUT 


3 
9045 E1 ERROR: POF H sRAISE STACK 
3046 El FOF H 
9047 SESF MVI As ’?’ 
9049 CN0658 CALL OUTT 
S04C C30050 JMF START #TRY AGAIN 


This routine will convert a string of ASCII-encoded octal characters 
into a 16-bit binary number in the HL register pair. The current value in the 
HL register pair is multiplied by 8 (the number base) by performing three 
DAD H instructions. The new byte is converted from ASCII to binary by 
subtracting an ASCII zero. It is checked at this time to ensure that it is in 
the proper octal range of 0 to 7. The addition of the new digit to the present 
value is more complicated than it was for the binary or hex routines. The 
problem is that there can be a carry out from the low-order byte. For this 
reason, the new byte is placed into the DE register pair, then combined with 
the value in HL by using the double-precision DAD D instruction. 


CONVERSION OF THREE ASCII OCTAL CHARACTERS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 


The routine given in Listing 8.7 will convert exactly three ASCII-encoded 
- octal characters into an 8-bit octal number in register C. The routine is pro- 
grammed for fixed-format input; therefore, exactly three characters must be 
given. Assemble the program, load it into memory, and start it up. Type in 
the following octal numbers, including the leading zeros. 


Since the largest 8-bit number is 255 decimal or 377 octal, the first digit 
must be in the range 0-3. The remaining two digits must be in the range 0-7. 
A check is made to ensure that the characters are in the proper range. The 
first ASCII character in the input string is converted to binary by subtracting 
an ASCII zero. The result is multiplied by 8 with three ADD A instructions 
and the result is saved in the C register. The next character is converted to 
binary and added to the first with the ORA C instruction. The new sum is 
multiplied by 8 again with three ADD A instructions, then saved in the C 
register. Finally, the third character is converted to binary and added in. The 
final result is moved to the C register. 


anne LC TL CE NTL CN CC LESL LLL TT tT RSAC SAT eReAtesassncmettntsmeteacnittmenmenesnnentmeruteiies 


NUMBER-BASE CONVERSION 167 


Listing 8.7. ASCII octal 8-bit binary in C. 


IF THREE DIGITS» LEFT ONE MUST BE <4 


THIS PROGRAM IS DESIGNED TO OFERATE 
WITH THE SYSTEM MONITOR AT S800 HEX 


JAN 225 80 


+ C3 eh ae sep on ar ae sas 


7000 RG J000H 

3 
9800 = MONIT EQU 3800H 
3806 = OUTT EQU MONIT+64 
~80C = INPLN EQU MONIT+0OCH 
J80F = GETCH EQU MONIT+OFH 
W812 = OUTHX EQU MONIT+12H 

? 
5000 3E0L START? MVI A» OLH sCARR RET 
9002 Ch04658 CALL OUTT , 
3005 SEOA MVI A’ OAH *LINE FEED 
3007 ChO658 CALL OUTT 
SOOA CHOCSS CALL INFLN §GET A LINE 
S00D Ch1IBSO CALL OcTSs sOCT/BIN 
5010 Ch1258 CALL OUTHX ¢PRINT HEX 
9013 3SE20 MVI As’ ¢ > BLANK 
9015 CnOé58 CALL OUTT 

g 

§ THE NEXT INSTRUCTION IS NEEDED WHEN 

§ THE ROUTINE IN LISTING 8.14 IS USED 

5 CALL OCT *RIN TO ASCII 
7018 C30050 JMF START gNEXT VALUE 

? 

§ CONVERT ASCII-ENCODED OCTAL 

§ TO 8-BIT BINARY NUMBER IN C 

? 
SO1B CH3550 OCT8: CALL OCTIN s15T CHAR 
JOLIE FEO4 CFI 4 sFIRST 
3020 024750 JNC ERROR §TOO LARGE 
3023 87 ADL A sTIMES 2 
3024 87 AnD A sTIMES 4 
3025 87 ADD A sTIMES 8 
3026 4F MOV CvA 9SAVE BYTE 
9027 C3550 CALL OCTIN §2NI CHAR 
JO2ZA Bi ORA Cc 3’ COMBINE 
902B 87 ADD A *TIMES 2 
S02C 87 ADL A *TIMES 4 
83O2D 87 Alt A sTIMES & 
JOZE 4F MOV C»A 
VO2F CH3550 CALL OCTIN >3RD0D) CHAR 
9032 Bi ORA C * COMBINE 
5033 4F MOV CrA *SAVE IN C 
9034 C9 RET 

3 

§ CONVERT INFUT CHARACTER 0-7 TO BINARY 

9 ; 
9035 CHOFS8 OCTIN? CALL GETCH 
9038 DA4650 JC ERR2 5NO CHAR 
SO3B 11430 SUI °O’ sASCIT BIAS 
3030 DA4650 JC ERR2 §TO0 SMALL 


rr 
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exeeoesmantznmu ronment me am ASO SORA Rt NACHNA ERR ARE NNN NCS AL CRLCSL AA CECA ACE 


3040 
9042 
3045 


3046 
9047 
3048 
sO4A 
3040 


FEO8 
n24450 
Ce? 


C1 
C1 
3E3F 
Cb0658 
C30050 


PRINT 


Sh Ip “GD 


ERR2¢ © 
ERROR: 


CFI 8 

JNC ERR2 TOO LARGE 
RET 

? ON IMPROPER INFUT 

FOF B sRAISE STACK | 
FOF B 

MVI Ay 7?! 

CALL OUTT 

JMP START 3TRY AGAIN 


CONVERSION OF TWO ASCII BCD DIGITS 
TO AN 8-BIT BINARY NUMBER IN REGISTER C 


The binary coded decimal (BCD) notation was introduced in Chapter 2. This 
method of encoding is less efficient than the binary notation. It takes more 
memory space to encode numbers, and mathematical operations can be 
considerably slower. The BCD notation, however, has two advantages. One 
is that conversion from decimal to BCD is simpler than conversion from 
decimal to binary. The second advantage is freedom from round-off error. 
The conversion routine given in Listing 8.8 accepts exactly two ASCII- 
encoded decimal digits and converts them into an. 8-bit BCD number in the 
C register. The routine can be repeatedly called to convert numbers with 
more than two characters. 


Listing 8.8. 


iodo uo HON 


CHOCS8 
CH2050 
87 


ASCII hex 


“ar “GP “a> “Ge “OD 


to BCI in C,. 


THIS PROGRAM IS DESIGNED TO OPERATE 
WITH THE SYSTEM MONITOR AT S800 HEX 


JAN 13% 80 

ORG 5OO0O0H 

¥ 

MONIT EQU 5800H 

OUTT EQU MONIT+64 

INPLWN EQU MONIT+0CH 

GETCH EQU MONIT+0OFH 

OUTHX EQU MONIT+12H 

bd 

START? MMVI A» OTH CARR RET 

~ CALL OUTT 

MVI A» OAH LINE FEED 
CALL. OUT T 
CALL INFLN *GET A LINE 

ROHL2? CALL HEX2 LEFT CHAR 
Alth A sTIMES 2 
alg A sTIMES 4 
Alin A ITIMES 8 
Alm A sTIMES 16 
MOV CA 9 SAVE 
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9015 Ch2050 CALL HEX2 gRIGHT CHAR 
3018 Bi ORA C §COMBINE 
O19? 4F MOV CrA 
YOLA Ch1258 CALL. OUTHX #FPRINT 
9010 C30050 JMF START §NEXT 
? 
. 9020 CHOFSS HEX23 CALL GETCH ¥HEX CHAR 


§ CONVERT ASCII CHARACTERS TO RINARY 


? 
O23 T4630 NIB; SUI °O"’ ¥ASCIT BIAS 
JO25 DAZBSO JC ERROR a2 0 
9028 FEOA CFI 10 
502A Ng RC §NUMBER 0-9 — 


PRINT ? ON IMPROPER INPUT 


a 
3 
a 
3 
- 
9 
E 


SO2KB SESF RROR? MVI Ay’?! 

9020 ChoOé58 CALL OUTT 

8030 C30050 JMF START yTRY AGAIN 
3 

033 ENN 


With the BCD notation, there is a 2:1 correspondence between the 
number of BCD digits and the necessary number of bytes. Or, put another 
way, two decimal digits are stored in each byte. This arrangement is some- 
times called packed decimal. The right decimal digit is encoded in the low- 
order four bits and the left digit is encoded into the high-order four bits. 


38 0011 1000 
27 0010 0111 
59 0101 1001 


BCD encoding involves essentially the same steps as does the hex-to-binary 
routine, except that only the characters 0 through 9 are allowed. The bit 
patterns corresponding to the hexadecimal numbers A through F are not 
allowed. 


CONVERSION OF AN 8-BIT BINARY NUMBER IN C 
TO A STRING OF EIGHT ASCII BINARY CHARACTERS 


In the first part of this chapter we developed programs to convert strings of 
ASClIl-encoded characters into binary numbers. The programs in the follow- 
ing sections will perform the reverse operation. Binary numbers will be 
converted into strings of ASCII-encoded characters. Furthermore, we will 
combine the new routines with those already developed so that they may be 
more easily tested. 

The program shown in Listing 8.9 can be used to convert an 8-bit 
binary number in register C into eight ASCII-encoded binary characters. The 
resulting characters are sent to the console in this case, but they could be 


meetin ninemsn tentnneceeeansnntrerrensnnneatesrinueneentenenneasepenisee ome 
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placed into sequential memory locations instead. This routine is incorpo- 
rated into the system monitor developed in Chapters 6 and 7. 


Listing 8.9 Binary in C to ASCII binary. 


THIS FROGRAM IS DESIGNED TO RUN WITH 
THE SYSTEM MONITOR AND WITH THE 
PROGRAM SHOWN IN LISTING 8.1 


PRINT AN 8-BIT BINARY NUMBER IN C AS 
8 ASCII-ENCONED BITS 


S> “Gt “GP “EP “He “BD “GP 


304A 0608 BITS: MVI By8 *8 RITS 
3040 79 BIT2: MOV ArC gGET BYTE 
2041 87 AnD A gSET CARRY 
SO4E 4F MOV CrA gPUT BACK 
SO4F 3E18 MVI Av’0’/2 ¢HALF OF O 
$051 8F ALC A §HOUBLE+CARRY 
‘$052 Cu0658 CALL OUTT 7ONE BIT 
BOSS OS DCR BR yCOUNT 
S056 C24C50 INZ BIT2 98 TIMES 
wOS9 CP RET 

¥ 
JOSA END 


Make a duplicate copy of the source program shown in Listing 8.1. 
This routine was used to convert ASCII-encoded binary characters into an 
8-bit binary number in C. Remove the semicolon from the instruction that 
reads 


5 CALL BRITS RIN TO ASCII 


Also delete the END directive if you used one. Add the lines given in Listing 
8.9 to the end of the program. 

The new routine works in the following way. Register B is initialized 
with the value of 8, the number of bits to be generated. Register C begins 
with the original binary byte. The bits of this byte are shifted to the left one 
at a time into the carry flag. The carry flag is then added to an ASCII zero 
to produce a 0 ora 1 at the console. For the 8080 version, the byte is moved 
to the accumulator, shifted left with an add instruction, then returned to 
register C. 

If the current high-order bit is a zero, then the carry flag is reset and a 
zero is printed. If the current high-order bit is a 1, then the carry flag is set 
and a 1 is printed. The count in the B register is decremented after each 
character is printed. When the count reaches zero, the process is terminated. 

Notice that the addition of the carry flag to the ASCII zero could have 
been accomplished with the instructions 


MVI Ay ’0’ 
ACI 0) 
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However, this will require four bytes. The code we will use, which is not so 
obvious, requires only three bytes. 


MVI As ’O°/2 
ANC A 


If you have a Z-80 CPU, this rouitine can be simplified and shortened 
by three bytes. Performing the rotation directly in the C register reduces 
the program by one byte. Two additional bytes are gained by using the 
decrement B, jump-not-zero operation. Now the accumulator can be zeroed 
with an exclusive-or operation and the carry can be added directly to an 
ASCTI zero. 


BITS: Lo By8 ¢8 BITS 

BIT23 XOR A ®ZERO A 
SLA L gSHIFT bt. LEFT 
ADC As ’O’ sADLT CARRY TO O 
CALL OUTT 3 SEND 
DINZ BIT2 38 TIMES 
RET 


Assemble the combined program, load it into memory, and start it up. 
Be sure that the monitor is in place at the address of MONIT. The new: 
binary-to-ASCII binary routine has been added in addition to the original 
binary to ASCII hex in the system monitor (OUTHX). Consequently, each | 
number will now be rendered in both hex and binary. Type in the following 
binary numbers. 


=O (you ture this) 

00 00000000 (both hex and hinary are siven) 
yl 

01 00000001 

2101 

05 00000101 

*10101010 

AA 10101010 

711110000 

FO 11110000 


Remember that the error-correction features of the monitor are available. If 
you inadvertently type a control-X, you will end up in the monitor itself. 
You can return from the monitor to the new program, however, by typing 


“G3000 


if this is where you assembled the new routine. 
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CONVERSION OF AN 8-BIT BINARY NUMBER 
INTO THREE ASCII DECIMAL CHARACTERS 


An 8-bit binary number can be converted into a string of ASCII-encoded 

decimal characters by repeated subtraction of powers of 10, the number 
base. The corresponding decimal number will lie in the range of zero to 255. 
The value of 100 (decimal) is repeatedly subtracted from the original binary 
number until the result becomes negative. One less than the number of 
subtractions is the number of hundreds in the decimal form. The result, 
which in this case can only be 0, 1, or 2, is added to the value of an ASCII 
zero, then sent to the console. 

As an example of the 100s subtraction, consider the number 137. 


137 

-100 (one subtraction) 
37 

—100 (too many) 


(negative number) 


Since there was one subtraction of 100 before the number became negative, 
the number is in the range 100 to 199. 

The value of the last 100 is added back to make the number positive 
again. Then the value of 10 is repeatedly subtracted from the new value 
until a negative result is again obtained. The number of tens in the decimal 
form is one smaller than the number of subtractions. This count is added to 
an ASCII zero and sent to the console for the middle digit. The value of ten 
is added back to the remainder. This adjusted remainder is then added to an 
ASCII zero to produce the units digit. It too is sent to the console. 

Continuing with the example: 


(negative number) 

+100 (add back last 100) 
37 

~10 (first subtraction) 
27 
—10 (2nd subtraction) 
17 

—10 (8rd subtraction) 


7 
-10 (too many) 


(negative number) 
_+10 (add back last 10) 


7 (units) 


Since there were three subtractions of 10 before the remainder became 
negative, the middle digit is a 3. Finally, the right digit is 7, the remainder 
after the last subtraction of 10. 
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Lisiting 8.10 gives the instructions for the conversion of an 8-bit binary 
number in register H. Register D initially contains the value of 100 (decimal) 
that is to be repeatedly subtracted from the number in H. As soon as the 
result of the subtraction becomes negative, the last 100 is added back, and 
the value in D is changed to a 10 by subtraction of 90. Register C is used to 
count the number of subtractions. It is initialized with the value of one less 
than an ASCII zero to simplify the conversion. 


Listing 8.10. Binary in A to ASCII decimal. 


IOS7 
9058 
5059 
JOSE 
vOST 
SOSF 
3060 
W061 
3064 
50635 
9066 
5067 
3069 
906C 
VO6TI 
SO6E 
‘SO6F 
3072 
9075 
9077 
3078 


YO7A §& 


JO7K 
907C 
507F 
3081 
3084 
3085 
3086 


O87 


DS 

CS 
1EOO 
14664 
OE2F 
oc 

92 
D25F 50 
82 


Croé58 
Ci 
N14 
C9 


BSE sce sap “Gs “ap “a> GP “Ge ‘cs “ce we 


ECS: 


HEC813 
DECB23 


NEC843 


DEC8S: 


“I> 


FEB 27s 80 


DECIMAL LIGITS. 


FUSH 
FUSH 


MMVI 
MVI 
MVI 
INK 
SUE 
JNC 
AD 
MOV 
MOV 
CFI 
JNC 
MOV 
ORA 
MOV 
JZ 
CALL 
MVI 
MOV 
SUI 
MOV 
MOV 
JNC 
ADT 
CALL 
FOF 
FOF 
RET 


ENT 


0 

Et 

E90 

iy 100 
Cr‘O%-1 
Cc 

a 

RnECS82 

0 


THIS FROGRAM IS DESIGNED TO RUN WITH 
THE SYSTEM MONITOR AND WITH THE 
FROGRAM SHOWN IN LISTING 8.4 


FRINT BINARY NUMBER IN A AS ASCII 
LEADING ZEROS SUPPRESSED 


sLEADING O FLAG 


9100 OR 10 
*STILL + 

,ADD BACK 
*REMAINIER | 
‘GET 100710 

9 ZERO? 

YES 

gCHECK FLAG 
sRESET? 
sRESTORE BYTE 
gLEADING ZERO 
yFRINT IT 
ySET O FLAG 


9100 TO 10 


yREMAINIER 


¥AGAIN 


gASCIT BIAS 


There is an additional feature added to this routine: leading-zero sup- 
pression. Leading zeros are typically suppressed when a number is expressed 


EN ae AR NE ACTA SOARS RA CA DOTA SRN cos hen eettimnenemeninounatsnsdeetneteiaemniesnimansanee sree 
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in decimal form. On the other hand, leading zeros are commonly left in 
place for binary, octal, and hexadecimal numbers. Thus, we write 


- for decimal numbers, but 


00001111 (binary) 
040 (octal) ( 
OFE3 (hexadecimal) 


for the others. 

. One reason for keeping leading zeros is to make it easier to distinguish 
octal or hex numbers from decimal numbers. With this convention, the 
~ number 0137 would be interpreted as an octal or hex value rather than a 

decimal number. The suppression of leading zeros is not a difficult task, but 
it does require some additional code. It is not sufficient to merely remove 
all zeros, for then the number 0307 becomes 37. 

One technique is to utilize a zero-suppression flag which is initially 
reset. Zeros are omitted as long as the flag remains reset. Then the flag is set 
when the first nonzero character is encountered. Subsequent zeros are not 
removed since the flag is set. 

The necessary zero-suppression code has been included in the routine 
shown in Listing 8.10. Register E is used for the flag; it is initially reset. — 
Then each character is checked with a CPI '1’ instruction to see if it is an 
ASCII zero. If the value is not a zero, it is printed and the flag is set to FF 
hex. On the other hand, if the digit is a zero, the flag is checked. If it is 
found to be reset, the zero is not printed. Only three decimal characters can 
be produced from the original byte; consequently, just the first two need to 
be checked. If the value of the byte is zero, a single ASCII zero is printed. 

The B, C, D, and E registers are utilized in the operations. Conse- 
quently, the original values are initially saved on the stack, then restored at 


_ the conclusion of the routine. 


Duplicate the program shown in Listing 8.4, the ASCII-hex to binary 
routine. Keep one of the copies as a backup, then rename the other one 
HEXDEC.ASM. Remove the semicolon at the beginning of the line 


3 CALL RECS 


and remove the END directive at the end of the program. Add the lines given 
in Listing 8.10. Assemble the combination program, load it into memory, 
and start it up by branching to the address of START. We have coupled the 
16-bit hex input program with the 8-bit decimal output program. Conse- 
quently, only the high-order byte will be converted to decimal. This is the 
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byte in the H register. Try the combined program with the following hex 
numbers. 


=O 

0000 0 

oo 

0001 O 

*100 

0100 1 

*AGOO 

OA00 10 (hex A is decimal 10) 
>1000 

1000 16 (10 hex is 16 decimal) 
>FFFF 

FFFF 2355 (FF hex is 255 decimal) 


This binary-to-decimal routine can be very useful at the CP/M systems 
level. Suppose that you want to save a program that starts at 100 hex and 
runs to 2736 hex. If the decimal routine is incorporated into a hexadecimal 
math routine of the system monitor, you have only to type 


>H2800 100 (command) 
2900 2700 39 (resronse) 


The response of 39 is the decimal number of 256-byte blocks to be saved. 
Then you can give the CP/M command 


A*SAVE 39 FILENAME.EXT 


CONVERSION OF A 16-BIT BINARY NUMBER 
INTO FIVE ASCII DECIMAL CHARACTERS 


In the previous section, we developed a routine to convert an 8-bit binary 
number into three ASCII-encoded decimal characters. We will now write a 
routine for converting a 16-bit binary number in HL into 5 ASCII-encoded 
decimal characters. This double-precision decimal number will range from 
zero to 65,5385. 

Duplicate the decimal-to-16-bit binary program in Listing 8.2. Remove 
the semicolon from the line 


9 CALL BIN 


and the END directive if you used one. Add the program shown in Listing 
8.11 to the end. 
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Listing 8.11 Binary in HL to ASCII decimal. 

THIS FROGRAM IS DESIGNED TO RUN WITH 
THE SYSTEM MONITOR AND WITH THE 
FROGRAM SHOWN IN LISTING 8.2 

FER 22% 79 


FRINT BINARY NUMBER IN Het AS ASCII 
DECIMAL DIGITS. LEADING ZERO SUPPRESSED. 


PYF “ap ae “a> wp sap ar ar “ap sae 


5055 0600 IND: MVI ByO sLEADING O FLAG 
5057 11F0n8 LXI Ity-10000 §2°S COMPL 
SOSA CDN7550 CALL SUBTR 10 THOUS 
S0SD 1118FC LXI Ly-1000 
3060 CD7550 CALL SUBTR ¥ THOUS 
5063 119CFF LXI Dy~100 
3066 CLh7550 CALL SUBTE sHUNDREDS 
3069 LIF GFF LXI . De-10 
S06C CD7550 CALL SUETR gTENS 
SO6F 70 MOV Ag. 
3070 C430 ALT ‘OQ¢ gASCII BIAS 
5072 C30658 JMPF OUTT sUNTITS 
? 
§ SUBTRACT FOWER OF TEN AND COUNT 
? 
3075 OE2F SUBTR: MMVI Cy’O’~-1 FASCIT COUNT 
3077 OC SUBT23 INR C 
9078 19 han ft gADD NEG NUMBER 
3079 DA7750 Jc SUBT2 gKEEF GOING 
3 
¢ ONE TOO MANY» ADD ONE BACK 
3 
SJO7C 7A _ MOV Av Il ’ COMPLEMENT 
3070 2F | CMA § Dee 
SO7E S57 MOV DrA 
307F 7B MOV AvE 
5080 2F CMA 
9081 SF MOV EsA 
3082 13 INX D sAND 
3083 19 DAT i 7400 BACK 
3084 79 MOV ArC *GET COUNT 
¥ : 
¢ CHECK FOR ZERO 
tf 
9085 FESL CFI ‘1’ gLESS THAN 17 
5087 029150 JNC NZERO §NO 
508A 78 MOV Ask gCHECK O FLAG 
S08B B7 ORA A gSET? 
5S08C 79 MOV AsC sRESTORE 
508D C8 RZ gSKIF LEADING O 
SO8E C30658 JMF OUTT §INTERIOR ZERO 
¥ 
§ SET FLAG FOR NON-ZERO CHARACTER 
F 
S091 O6FF NZERO$ WMVI ByOFFH #¢SET O FLAG 
3093 €C30658 JMF OUTT gPRINT IT 


OPS END 
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This 16-bit version is similar to the 8-bit version of the previous section. 
This time we start with the subtraction of the decimal value 10,000 instead 
of 100. The number of subtractions is counted as before. When the result - 
becomes negative, the last 10,000 is added back. The number of subtractions 
that was performed is the desired digit for the ten-thousandths position. 

Since the 8080 CPU does not incorporate a 16-bit subtraction operation, 
the subtraction is obtained by adding the corresponding two’s complement 


LXI Ity-10000 


DAD D 


The carry flag will be set for each addition (subtraction) except the last. The 
carry flag is then reset for the operation corresponding to the result becom- 
ing negative. The JC instruction in subroutine SUBTR causes the computer 
to loop the correct number of times. Suppose, for example, that the binary. 
number in HL corresponds to the decimal number 32,128. This is the’ 
equivalent of the hexadecimal value 7D80. The two’s complement of 10,000 
is D8F0 hex. The sum of these two is 


decimal hexadecimal 


329128 7080 
-~107000 +08F0 
229128 9670 


Thus the addition of 7D80 and D8FO hex is equivalent to subtracting 
10,000 from 32,128. . 

The last subtraction that causes the result to become negative has to be 
undone. This could be accomplished by adding 10,000. However, the addi- 
tion is accomplished in subroutine SUBTR which is also used to add back 
the 1,000, 100, and 10 for the equivalent steps of each decade. Therefore, 
we won’t know, in general, which value to add. The solution is to obtain the 
necessary value from the two’s complement of the two’s complement for 
the current value. This two’s complement is first obtained by complementing 
both the D and the E register to produce the one’s complement. Then the 
DE register pair is incremented. Subroutine SUBTR is first called with DE 
set to —10,000, then to —1,000, -100, and -10. At this point, the units me 
is contained in the L register. 

This double-precision routine also incorporates instructions for sup- 
pressing leading zeros. The approach is similar to the one used in the previous 
section except that the H register is used for the zero flag. 

Assemble the combination program, load it into memory, and start it 
up. Enter the following decimal numbers. The response will include both the 
hexadecimal and the decimal values of the input number. 
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Ine NE EEE NTE SET ner en asa eens oeeeateteennmeeennnnmennnnemmeneel 


20 - 

0000 0 

1 

0001 1 
>100 

0064 100 
21024 

0400 1024 
265535 
FFFF 465535 


At this point you may want to incorporate decimal numbers into the system 
monitor. When we incorporated an ASCII-input feature into the monitor we 
used the apostrophe to indicate this fact. It is customary to precede decimal 
~ numbers by a number sign. For example, the following input would indicate 
decimal input. 


>H#1024 $200 


CONVERSION OF AN 8-BIT BINARY NUMBER 
INTO TWO ASCII HEXADECIMAL CHARACTERS 


The conversion of an 8-bit binary byte into two ASCII-encoded hexadecimal 
characters is an interesting exercise. The high-order four bits are represented 
by one hex character, and the low-order four bits are represented by the 
other hex character. Since the upper character is printed first, the upper four 
bits are rotated down to the lower position. These new lower four bits are 
converted to ASCII to produce the first character. Then the original low- 
order four bits are converted to ASCII to get the second character. 

The nibble conversion appears to be straightforward. The upper four 
bits are zeroed by performing a masking AND with the value of OF hex. The 
lower four bits are then converted to ASCII by the addition of an ASCII 0. 
If the result is in the range 0-9, then the conversion is complete. Otherwise, 
a binary 7 is added to the result, converting it to an ASCII-encoded letter of 
A through F. 

To see why this conversion works, look at the ASCII table in Appendix 
A. The ASCII number 9 has a decimal value of 57. The ASCII letter A has a 
decimal value of 65. But the hexadecimal value of A follows the value of 9. 
Therefore, we need to add 7 to any valid hex number larger than 9 to con- 
vert it into the appropriate ASCII letter A through F. 

The program shown in Listing 8.12 will convert an 8-bit binary number 
in the C register into two ASCII characters and send them to the console. 
Duplicate the program in Listing 8.5. Remove the external reference to 
subroutine OUTHX near the beginning. 


QUTHX EQU MONIT+i2H 


Our new program will perform the same function. Also remove the final 
END directive if you used one. Copy the lines from Listing 8.12 on the end 
of the program. Assemble the combined program, load it into memory, and 
ee Ee ae a 
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start it up. Our monitor will still have to be in memory since we will need 
the I/O routines. This current version, Listing 8.12, with the built-in binary- 
to-hex routine, should respond exactly the same as the earlier version, 
Listing 8.5. The only difference is that we are converting binary to hex 
within the program rather than using a routine in the monitor. 


Listing 8.12 Binary in C to ASCII hex 

THIS FROGRAM IS DESIGNED TO RUN WITH 
THE SYSTEM MONITOR AND WITH THE 
FROGRAM SHOWN IN LISTING 8.5 

JAN 18% 80 


ROUTINE TO OUTPUT 2 HEX CHARACTERS FROM C 
8-EIT BINARY TO ASCII HEX CONVERSION 


CQ we ap sap sae wae ee sae ae ae 


3043 79 UTHX3 MOV AsC *GET BYTE 
3044 1F RAR *ROTATE 
S045 1F RAR » FOUR 
O46 IF RAR * BITS TO 
S047 1F RAR § THE RIGHT 
37048 Ch4cso CALL HEX1 SUFFER CHAR 
sO4E 79 MOV AsC gLOWER CHAR 
¥ 
YO4C ESOF HEX1: ANI OFH sLOW 4 BITS 
YO4E C430 ADI QO’ sASCII ZERO 
S050 FEZA CFI OCH 70 TO 9 
9052 NA06SS JC OUTT sYES 
9055 C4607 ANT 7 * CONVERT 
2057 C30658 JMP OUTT gA TO F 
? 
SOSA END 


The algorithm used to convert the binary nibble to a hex character 
clearly demonstrates the technique. But there is a more efficient method for 
CPUs such as the 8080 and Z-80 that incorporate the decimal adjust accum- 
ulator (DAA) instruction. Change the second, third, fourth, and fifth lines 
of subroutine HEX1 so the subroutine looks like 


HEX1: ANI OFH (same) 
ADI 9OH (new) 
DAA (new) 
ACI 40H (mew) 
DAA (mew) 
JMP OUTT (same) 


Conversion of a 16-bit binary value into four hex characters is obtained 
by calling the 8-bit routine twice. For example, the HL register pair can be 
printed with the following routine. 


OUTHL? MOY CoH. 
CALL OUTHX 
MOV Cel. 


CALL QUTHX 


cna 


180 8080/Z-830 ASSEMBLY LANGUAGE 


ere spueesnaresnzoscmeseananesmmpaneetnanetnn annem NERA EN ANTE AEN AN EEE EET CLC ET IE 


Conversion of a binary number to a string of ASCII-encoded BCD 
characters does not require a special routine. It is performed simply by 
calling the binary-to-hex routine OUTHX. 


CONVERSION OF A 16-BIT BINARY NUMBER 
INTO SIX ASCII OCTAL CHARACTERS 


A 16-bit binary number in the HL register pair can be converted into six 
ASCII-encoded octal characters by repeatedly shifting the double register to 
the left. We make use of the double-register add instruction DAD H. This 
instruction adds the register pair HL to itself. The operation is equivalent to 
a double-precision arithmetic shift left. All 16 bits are shifted left and a zero 
is moved into the lowest order bit. The carry flag is set if the original highest- 
order bit was a logical one. The carry bit is reset otherwise. 

The routine is shown in Listing 8.13. As the bits of the double register 
are shifted out the high end, they are converted to the corresponding octal 
number in the accumulator. The largest 16-bit octal number is 177777; 
~ consequently, the first octal character (starting from the left) can only be a 
zero or a one. The remaining five characters can range from zero through 7. 
They are obtained from groups of three bits. 


Listing 8-13 Binary in HL to ASCII octal. 


THIS FROGRAM IS DESIGNED TO RUN WITH 
THE SYSTEM MONITOR AND WITH THE 
FROGRAM SHOWN IN LISTING 8.4— 


JAN 18% 80 


ROUTINE TO OUTPUT A 16-BIT BINARY 
VALUE IN Hel AS OCTAL CHARACTERS 


a 
? 
“ 
7 
* 
? 
s 
9 
a 
? 
a 
9 
a 
? 
cod 
? 
a 
g 


3OS2 ES UTOCT: FUSH H §SAVE VALUE 
9053 CS FUSH B 
9054 0605 MVI ByS 95 CHAR 
3056 AF XRA A 9 ZERO 
3057 29 NAD H sHIGH BIT 

$058 CE30 ACI QO’ sADDED IN 
SOSA CHhOé658 CALL OUTT sPRINT IT 
SOSD 3E06 OCT2: MVI Aré sROTATE 60Q 
SOSF 29 DAN H i CARRY 

. 93060 17 RAL sROTATE TO A 
S061 29 Dal H yAGAIN 
9062 17 RAL 9TO0 A 
3063 29 An H §3R0 TIME 
3064 17 RAL TO A 
9065 CDO6S8 CALL OUTT gF RINT CHAR 
3068 OS DCR B # COUNT 
5069 C25050 JINZ OCT2 99 TIMES 
506C Cl FOF B 
906D Ei POP H 
SO6E C9 RET 


<> 


S06F END 
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The first step shown in Listing 8.13 saves the HL and BC registers on 
the stack. This operation may not always be necessary. The XRA operation 
is used to zero the accumulator. It must be performed before the DAD H 
instruction since it resets the carry flag. The DAD instruction will set the 
carry flag if the high-order bit was a 1, or reset the flag if the high-order bit 
was a zero. The carry flag is then added to an ASCII zero and sent to the 
console. = 
The remaining five digits are generated in a loop starting at label OCT2. 

Register B is preloaded with the value of 5 to count the remaining digits. 
We need to transfer the current three high-order bits from the H register into 
the accumulator. This is accomplished by three DAD H instructions. After 
each one, the carry flag will reflect the state of the most recent high-order 
bit of H. After each DAD instruction, we perform a rotate accumulator 
instruction. This moves the carry bit into the low-order bit of A. After three 
such operations, the three low-order bits of the accumulator will contain 
the proper octal bit pattern for the appropriate character. But they are in 
binary form and we need to convert them to ASCII for printing. 

The bit pattern for the ASCII zero is 011 0000. Notice that it contains 
zeros in the lower four bit positions. At the beginning of the OCT2 loop we 
preloaded the accumulator with a binary 6 which has a bit pattern of: 
000 0110. At the conclusion of the OCT2 loop, the three rotations will 
convert this binary 6 into a 60 octal which is equivalent to an ASCII zero. 
This effectively converts the three lower-order bits, shifted in from the carry 

flag, into ASCH-encoded octal. 
The Z-80 version can be a little shorter if the instruction 


DJINZ OCT2 
is used in place of 


DCR RB 
JINZ OCT2 


CONVERSION OF AN 8-BIT BINARY NUMBER 
INTO THREE ASCII OCTAL CHARACTERS 


In the previous section we derived a subroutine for the conversion of a 16-bit 
binary number into ASCII characters. The conversion of an 8-bit binary 
number to octal will be considered here. We could use the H,L double 
register, as previously, to perform the necessary shifts. However, if the H,L 
register is needed for something else, such as a pointer to memory, then 
another method would be better. ay 

The routine shown in Listing 8.14 performs the needed rotations in the 
accumulator. The original binary byte is in the C register. The byte is moved | 
to the accumulator and two left circular rotate instructions are performed. 
This effectively moves the two high-order bits down to the two low-order 


ecm antennae ronnie cn enon 
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positions. It is equivalent to performing six right circular rotations. The 
remaining bits are zeroed with a logical AND 3 step. The ubiquitous ASCII 
zero is added, and the result is sent to the console. 

The middle character is obtained by rotating the original byte to the 
right. A logical AND 7 isolates these low-order bits. The ASCII zero is added 
and the byte is sent to the console. The original byte is retrieved a third 
time. Now the three bits of the third character are properly positioned. 
Hence no rotation is needed. The masking AND operation is still needed, 
however. Finally, the ASCII zero is added prior to printing. 

Type the program shown in Listing 8.14. Add the new program to the 
end of the octal-to-binary program shown in Listing 8.7. Assemble the com- 
bination, load it into memory, and branch to the beginning. Remember that 
the input requires exactly three octal characters. If less than three are used, 
an error message of a question mark will be printed. If more than three 
characters are typed, only the first three will be used. 


Listing 8.14. S-bit binary in C to ASCIT 

THIS FROGRAM IS DESIGNED TO RUN WITH 
THE SYSTEM MONITOR ANDI WITH THE 
FROGRAM SHOWN IN LISTING &.7 

JAN 22% 80 


ROUTINE TO OUTPUT AN 8-BIT BINARY 
VALUE AS THREE OCTAL CHARACTERS 


Co ap ae ae “o> “cr sar sce > “a> 


9053 79 CT: MOV Arl sGET IT 
3054 07 RLC §2 HIGH BITS 
SOSS 07 RLC 
5056 E603 ANI 3 3MASK 
5058 CN46550 CALL OCTS 
DOSB 79 MOV AsyC §GET AGAIN 
OSC OF RRC gMIDDLE BITS 
SOSr OF RRC 
SOSE OF RRC 
SOSF CN46350 CALL OCT2 
3062 79 MOV AsC sRIGHT BITS 
5063 E607 OCT2: ANI 7 93 BITS 
3065 C630 OCTS: Ant os sASCIT BIAS 
3067 C€30658 JMP OUTT gPRINT 

? 
JO6A ENT 


CONVERSION OF A 16-BIT BINARY NUMBER TO SPLIT OCTAL 


Some of the 8080 and Z-80 instructions can have either 8-bit or 16-bit 
operands. Typical 8-bit operations for the 8080 are 


MVI Av10 
ALI 3 
ANI 7 


qemeereirisrcamannas_rsseaneennmanennarantbinimsiaiantnes ae aASCaTtNe Cette TRENTON NEALE NCCCT ECCT ANCONA 
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The 16-bit operations include 


CALL 1LOOH 
JMP S005H 
LXI Hed 


But the 8-bit architecture of microcomputers means that 16-bit operands are 
stored as two consecutive bytes. Each byte can be represented as two hexa- 
decimal characters. And the entire 16-bit value can be represented by a 
combination of all four of these hex characters. For example, the 16 bits 


11110000 10101010 
can be represented with the hex characters 
FOAA 


Alternately, the left byte can be represented by an FO hex, and the right 
byte can be expressed as AA hex. There is no problem here since each hex 
character represents four bits, and both 8 and 16 are evenly divisible by 4. 

Octal representation is more complex. In this case, each octal character - 
represents three bits (or sometimes two). Since neither 8 nor 16 is evenly 
divisible by 3, a problem can occur. Consider the 16-bit value 


1 111 010 011 101 010 
It can be represented in the octal notation as 

172352 
This is the result that the program in Listing 8.13 would produce at the 
system console. The problem is that the 16 bits are actually stored in two 
adjacent 8-bit locations. If the bit pattern is grouped into 8-bit bytes, it 
looks like this. 

11 110 100 11 101 010 
In this arrangement, the two corresponding octal bytes are represented as 


364 352 


The result, which has been termed split octal or crazy octal, looks very 
different from the corresponding 16-bit octal value of 172352. The two 
octal bytes of split-octal notation are sometimes separated by a colon to 
distinguish the representation from the regular 16-bit octal. 


364:352 
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The split-octal notation can be readily implemented, as shown in 
Listing 8.15. This program is adapted from the 8-bit octal-to-binary and 
binary-to-octal routines given in Listings 8.7 and 8.14. The first part takes 
two separate octal bytes and converts them to an 8-bit binary number. The 
second part converts the binary byte into two octal bytes. Each split-octal 
number is entered from the console as two groups of three characters. A 
space or colon can be used to separate the two parts. 


Listing 8.15. Srlit-octal routines 


3000 


9800 
1806 
380C 
J8OF 
s812 


39000 
3002 
(9005 
3007 


SO0R - 


5000 
5010 
5011 
5014 
5015 
5018 

SOLA 
5010 


37020 


2023 
O26 
2027 
sO2A 
O20 
10350 
O31 


HoH HOH OU 


CHO6S8 
CN6850 
C30050 


CH3250 
a1 
CDOFSS 
DASFSO 
CNB250 
ue 


c? 


Sb > “G> “Win GD “Sb WS “Ep “Gp GP 


6 OCTAL CHARACTERS SEPARATED BY A 
SPACE ARE ENTERED FROM THE CONSOLE. 
A i16-BIT BINARY NUMBER IS PRODUCED 
IN ItvE. THIS IS RECONVERTED TO OCTAL. 


THIS PROGRAM IS DESIGNED TO OPERATE 
WITH THE SYSTEM MONITOR AT S800 HEX 


JAN 225 80 


ORG 3000H 

5 

MONIT EQU ~800H 

OUTT EQU MONTT+6 

INPLN EQU MONIT+0CH 

GETCH EQU MONIT+OFH 

OUTHX EQU MONIT+12H 

5 

START: MVI Av ODH gCARR RET 


C3 sar sa sar 


“Gp ‘ed “Gh “Ge 


CALL OUTT 
NVI Ay OAH gLINE FEEL 
CALL OUTT 
CALL . INFLN ‘GET A LINE 
CALL OCTSS 6 OCT CHAR 


MOV - CvD sFIRST 
CALL OUTHX 970 HEX 
MOV Crk 9SECONE! 
CALL OUTHX §T0 HEX 
MVI Ag! 7” 9 BLANK 


CALL OUTT 
CALL OUTS8O ®>7T0O BINARY 
JMP START §NEXT VALUE 


6& SFLIT-OCTAL CHAR TO 16-BIT BINARY 


CT88: CALL OCTS gFIRST 
MOV De * SAVE 
CALL GETCH §SFACE 
Jc ERRS PONLY 1 CHAR 
CALL OcTs ’SECOND 
MOV Ev » SAVE 
RET 


CONVERT ASCII-ENCOUDED OCTAL 
TO 8-BIT BINARY NUMBER IN C 


9032 
W035 
3037 
JOSA 
SO3B 
303C 
vO3D 
JOSE 
S041 
v042 
5043 
JO44 
JOAS 
046 
OA? 
JO4A 
304B 


304C 
JO4F 
O92 
7054 
JOG7 
v0S9 
vOSC 


3050 
JOSE 
JOSF 
3060 
37062 
9065 


3068 
3069 
VO6C 
JO6E 
sO7 1 


JO?72 
9073 
3074 
O75 
9077 
J07A 
JO7K 
307C 
5070 
SO7E 


Co4CSo 


AF 


Ch4cso 
Bi 
AF 
C9 


CROFSS 
DASSO 
hé30 
DASDISO 
FEO8 
D25050 
C9? 


ChO4658 
C30050 


4A 
CO7250 
SESA 
ChO658 
4B 


E603 
ChB4S50 
79 

OF 

OF 

OF 
CN8250 


ocTs: 


CONVERT INPUT 


Co se ee sa 


CTIN: 


@> “Gp “ie 


ERR2 ¢ FOF 

ERROR? FOF 

ERRS: FOF 
MVI 
CALL 
JMP 


16-BIT BINARY 
UT803 


Gj «> «> «> «a> 


CT: 


RRC 
CALL 


FRINT ? ON IMPROPER 
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OCTIN 31ST CHAR 

4 FIRST 
ERROR 3TOO0 LARGE — 
A TIMES 2 

4 sTIMES 4 

A ‘TIMES 8 
CA §SAVE RYTE 
OCTIN 32ND CHAR 
§COMBINE 

A S;TIMES 2 

A sTIMES 4 

A sTIMES 8 
CeAé 

OCTIN g3RD CHAR 

c §5COMBINE 
CeA 3SAVE IN C 


CHARACTER O-7 TO BINARY 


GETCH 

ERR2 9NO CHAR 

‘0’ gASCITI BIAS 

ERR2 9TO00 SMALL 

8 

ERR2 §TOO LARGE 
INFUT 

B sRAISE STACK 

R 

B 

As“?! 

OUTT 

START §TRY AGAIN 


IN DeE TO SFLIT OCTAL 


Crd sFIRST BYTE 
OCT >TO OCT 
Ay’3’ 

OUTT §SEFARATOR 
CoE §SECOND 


ROUTINE TO QUTPUT AN 8-BIT BINARY 
VALUE AS THREE OCTAL CHARACTERS 


Arf >GET IT 
$2 HIGH EITS 
3 3MASK 
OCT3 
Art §3GET AGAIN 
sMIDOLE BITS 
OcT2 
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3081 79 MOV ArC sRIGHT BITS 


5082 E607 ocT2: ANI 7 $3 BITS 
5084 C430 OCcT3: ALI “O° SASCII BIAS 
5086 C30658 JMF ourT SPRINT 
3 : 
5089 END 


The input number is converted into a 16-bit binary number in the D,E 
register pair by calling the 8-bit routine twice. The hex value is printed out 
as usual, then the split-octal version. A colon in the middle separates the 
two halves. 

Assemble the program and try it out. 


“177 377 (a space serarator) 
7FFF 1773377 
%1003200 (a colon serarator) 
4080 1003200 


This completes the base-conversion routines. At this point, you may want to 
incorporate some of these routines into your system monitor. 


CHAPTER NINE 


Paper ‘Tape and 


Routines 


Magnetic Tape | 


It is possible to encode complete programs, such as a BASIC interpreter, into 
ROM so that calculations, such as the square root of 19, can be performed as 
soon as the computer is turned on. But more complicated problems will 
require a source program. If the source program is used frequently, then it 
would be inconvenient to reenter the source program each time it is needed. 
One way to avoid this reentry problem is to save the source program some- 
how and then reload it into the computer when it is needed. 

But BASIC is not the only computer language. Some tasks are more 
easily performed with other languages, such as Pascal or APL. Assembly 
language is useful for systems programming. A full text editor program has 
more features than the most complex BASIC interpreter. Thus, it is better 
not to have the BASIC interpreter in ROM. Instead, a small monitor pro- 
gram, such as the one developed in Chapter 6, can be placed in ROM. We 
can use this small monitor to load larger programs from an external medium. 

The floppy disk is a convenient medium for saving and reloading 
programs. The cost, however, is greater than other storage media such as 
paper tape or magnetic tape. Even if a floppy-disk system is utilized for 
program storage, it might be wise to make backup copies on magnetic or 
paper tape. 

The simplest storage method is to utilize the paper tape accessory 
available on some Teletype machines. With this approach, a separate com- 
puter I/O port is unnecessary. Furthermore, paper tapes can be read directly 
on the Teletype, without using a computer. The disadvantage of this method 
is that the transfer rate is low, since the Teletype operates at only ten char- 
acters per second. 

A more complicated, but faster, method utilizes an ordinary magnetic 
tape machine designed for home recording. In this case a separate I/O port 
will usually be necessary, but the advantage is that the recording rate is 
higher than for paper tape. Common data transfer rates range from 30 to 
over 120 characters per second. 
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The frequency response of audio tape recorders is limited to a maxi- 
mum of 10 to 20 kHz. But since the computer operates at 2 or 4 MHz, the 
signals from the computer cannot be directly copied onto tape. 

One solution is to convert the computer’s digital signals into sine waves 
that can be easily recorded. A -digital-to-analog (D/A) circuit is used for this 
purpose. When the recorded program is subsequently played back into the 
computer, a separate analog-to-digital (A/D) circuit reverses the process. It 
converts the signal from a sine wave back into the digital form. The D/A and 
A/D circuits are combined on a printed circuit board with the usual parallel- 
to-serial converter for the I/O port. 


THE CHECKSUM METHOD 


Two separate tape-handling routines are given in this chapter; both may be 
used with paper tape or magnetic tape. They are both suitable for storing 
binary object programs, ASCII-encoded source programs, or just a set of 
numbers. The information is stored in a file consisting of a sequence of 
records. Each record contains a checksum that is used to detect errors. 

Errors can be introduced at several places in the tape-recording and 
playback process. The proximity of AC power cords to audio signal lines can 
change the transmitted signal. Oxide layers may fall off the tape, or there 
may be a defective spot on the recording surface. If the recording and play- 
‘back heads are dirty, they can incorrectly render the signal. The A/D conver- 
sion step, when the tape is played back, can also give rise to errors. 

In addition to the data, each record stored on the tape contains the 
. record length, the memory address of the record, and a checksum byte. The 
checksum byte is obtained by adding all of the data bytes in the record. 
When the tape is read back, the computer sums up the data and compares 
the result to the checksum value written on the tape at the end of the rec- 
ord. A discrepancy indicates an error. . 

Since an 8-bit checksum is used in both programs, there are 256 possi- 
ble combinations. Any single load error in the record will be discovered by 
this method. In principle, it is possible that two errors in the same record 
- will combine to produce the expected checksum value. In practice, however, 
this is not likely to be a problem. Double errors occur much less frequently 
than single errrors. Furthermore, in a well-tuned system, single errors should 
be infrequent. They are most likely to be caused by low-quality tape, a dirty 
head, or a mistuned A/D converter circuit. Buy the best tape you can and 
clean the heads often. A routine that can be used for aligning the A/D circuit 
is incorporated in the second tape routine given later in this chapter. 


AN ASCII-HEX TAPE PROGRAM 


The tape program given in Listing 9.1 is based on an ASCII-encoded hexa- 
decimal format. It can be used to produce paper tapes or magnetic tapes of 
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computer programs. It can even produce a tape of itself. The program is 
self-contained and assembled to run at 100 hex. No outside routines are 
required. An additional feature of this program is that it can punch readable 
labels on the leader of a paper tape. (Of course, this feature is not very 
useful for magnetic tape recordings.) The label routine is discussed in the 
next section of this chapter. 


Listing 9.1-Hexadecimal tare routines. 


§ HEXMON? A MONITOR TO DUMP > LOAD ANT 
3 VERIFY INTEL HEX CHECKSUM TAPES 
5 WITH TAPE LABEL FOR HEADER 
3 
TITLE “hexmon with tlabel ’ 
3 
0100 ORG 100H 
5 
3 
FSP P SRST FR REPS RSPR SPT ST FH TSS SSSR TEESE 
3 
0010 = RLEN EQU 146 #RECORE LENGTH 
3 
O01i0 = CSTAT EQU 10H sCONSOLE STATUS 
ooli = CDATA EQU CSTAT+1 SCONSOLE DATA 
0001 = CIMNSK EQU 1 sIN MASK 
0002 = COMSK EQU 2 sOUT MASK 
0006 = FSTAT EQu é SFUNCH STATUS 
0007 = FIATA EQU PSTAT+1 $FUNCH DATA 
0001 = FINSK EQU 1 jPUNCH IN MASK 
0080 = FOMSK EQU SOH sFUNCH OUT MASK 
3 
ooon = CR EQU 13 *CARRAGE RETURN 
OOO0A = LF EQU 10 sLINE FEED 
OO7F = DEL EQu 127 
0008 = CTRH EQu 8 §“H CONSOLE BACKUF 
0000 = NNULS EQU 0 sCONSOLE NULLS 
POPP SSSR ESE ST STH RPT SSF PRES TS PSR SRE RRR RR GS 
3 
0100 C3701 START3 JMF CONTIN 
} 
*’ INPUT A BYTE FROM THE CONSOLE 
3 
0103 DBIO INFPUTT$ IN CSTAT 
0105 E601 ANT CIMSK 
0107 CAQZ01 JZ INFUTT 
010A DBI IN CHATA 
010C E67F ANI 7FH sSTRIF FARITY 
O10E C9 RET 


OUTFUT A CHARACTER TO CONSOLE 


> “I> ‘oF 
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O10F FS OUTT: PUSH FSW 
0110 DRIO OUTWs IN CSTAT 
0112 E602 ANT COMSK 
0114 CALOO1 JZ OUTW 
0117 Fil FOF FSW 
0118 D3it OUT CATA 
O11A C9? RET 


OUTPUT Hel TO CONSOLE 
16-BIT BINARY TO HEX 


4 

3 

ad 

9 

a 

3 
0 


OL1B 4C UTHL: MOV CyH gFETCH H 
~O11C Cp2001 CALL OUTHX sPRINT IT 
O11F 40 MOV Crk gFETCH Ly» PRINT IT 
§ 
§ CONVERT A BINARY NUMBER TO TWO 
9 HEX CHARACTERS» AND FRINT THEM 
9 
0120 79 OUTHX: MOV AsC 
Ol21 IF RAR sROTATE 
O122 1F RAR ’ UPFER 
0123 1F RAR ¢ CHARACTER 
0124 IF RAR § TO LOWER 
0125 CD2901 CALL HEX1 sOUTFUT UPPER 
0128 79 MOV Asl sOUTFUT LOWER 
3 
§ OUTFUT A HEX CHARACTER 
> FROM LOWER FOUR BITS 
: : : 
0129 E60F HEX: ANI OFH STARE 4 BITS 
0128 C690 — ABI 144 
Ol2n 27 DAA DAA TRICK 
O12E CE40 Ac! 64 
0130 27 DAA yONCE AGAIN 
0131 C30FO1 JMP OUTT 
9 
§ CONVERT ASCII CHARACTER FROM CONSOLE 
§ TO 4 BINARY BITS 
3 
0134 0630 NIBG SUI ma gASCII BIAS 
01346 D8 RC ee 9 
0137 FEI? CFI See ON ed. 
0139 SF CMC 9 INVERT 
015A DB RC ERROR, > ’F? 
O13B FEOA CFI 10 
O13D JF CNC § INVERT 
O13E Do RNC sjNUMBER IS 0-9 
O13SF D607 SUI ie 2 ee dete | 
O141 FEOA CPI 10 
0143 C9 RET gCHARACTER IS A-F 
? 
9 INPUT Hel FROM CONSOLE 
5 
0144 DS READHL? FUSH i 
0145 CS FUSH B 
0146 210000 LXI HO START WITH O 


0149 CD0402 ROHL2: CALL GETCH 


014C 
O14F 
0152 
0155 
0156 
0157 
0153 
0159 
O1SA 
O1SB 


O1SE 
0160 
0163 
0165 
0168 
0169 
O16A 


O16B 
0160 
0170 


0173 
0174 
0175 
0176 
0179 
017A 


o170 
0180 
0183 


0186 
0189 
018C 
O18F 
0191 
0194 
0196 
0199 
O19R 
O1L9E 
O1A0 
O1AS 
OLAS 


HASSO1 
C0N3401 
DASEOL 


C34901 


FEFC 
CA6SO1 
FEFO 
C26B01 
C1 

D1 

C9 


SE SF 
CHOFOL 
C30001 


C37301 


312106 
118603 
CD7301 


312106 
CHACO1I 
CDO402 
FES? 
CALAQ2 
FES2 
CAE46O2 
FE45 
CAESO2 
FESS 
CAE6O2 
FE47 
C26B01 


PAPER TAPE AND MAGNETIC TAPE ROUTINES 191 


AT 


BJ a> ap we ae 


DHL 43 


ROHL S 3 


a 


3 
ERROR? 


a 
3 
a 
3 
a 
3 
a 
3 
S 


ENDM? 


4 


? 
CONTIN: 


4 


9 


RSTRTs 


CHECK 
END OF 


FOR 


LDAX 
ORA 
RZ 
CALL 
INX 
JMF 


LXI 
LXI 
CALL 


RDHLS 
NIB 
RDHL 4 
H 


H 

L. 

Lea 
ROHL 2 


yEND OF LINE 
SCONVERT TO BINARY 
7NOT HEX 

9146-KIT 

¢ SHIFT LEFT 


gCOMBINE NEW 


§NEXT 


COMMA OR BLANK 


ALDIRESS 


og l—'Q° 
REHLS 
soft ge 
ERROR 
R 

it] 


Ar’?! 
OUTT 
START 


Vt 
A 


OUTT 
D 
SENIM 


SF »STACK 


De SIGN 
SENDIM 


SF se STACK 


INPLN 
GETCH 
‘Wl’ 
FDOUMF 
ae 
PLOAD 
“ft 
FLOAT 
“ye 
FLOAL 


sCOMMA? 

sYES» OK 
3 BLANK? 

9NO 


SIMFROPER INPUT 


$TELL HOW AGAIN 


SEND CHRACTERS POINTED TO BY DvE 


UNTIL A BINARY ZERO IS FOUND 


“$NEXT BYTE 


sSEE IF ZERO 
’ DONE 


§MESSAGE 
§SEND IT 


7GET A LINE 
yINFUT THE TASK 
3’ DUMP 


sREADs NO AUTOSTART 
sLOAD AND EXECUTE 
*VERIFY 


*GO SOMEWHERE 
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°O1A8 


O1AB 


O1AC 
O1LAF 
O1B1 
O1B4 
O1B? 


' O1LBA 


O1BC 
O1LBF 
01C1i 
0104 
01CS 
01c9 
O1CB 
O1CE 
0100 
o1ni 


O1B3 


01n4 
0107 
O1n8 
o1n? 
O1LIA 
OoiDD 


O1EO 
O1E2 
O1ES 
O1E7 


O1EA 
O1EB 


O1EE 
O1FO 
O1F3 


Ch440l1 
E? 


CDEEOI 
SESE 
CDOF OI 
212406 
222106 
OE00 
CHosol1 
FE2O 
DAEOOL 
FE7F 
CAFSO1 
FESB 
DALvOOL 
E465F 
77 
SE20 
B9 
CABCOL 
7E 

23 

oc 
COOFOL 
C3BCO1 


FEOS8 
CAF SOL 
FEOD 
C2BCO01 


79 
322306 


SEOr 
CDOFOL 
SEOA 


$ JUMP TO ANOTHER PROGRAM 
; 


CALL READHL JUMP ADDRESS 
JPCHL? FCHL 20K, GOODBYE 
5 
§ INPUT A LINE FROM THE CONSOLE 
¢ AND FUT IT INTO A BUFFER 
? 
INPLN? CALL CRLF 
MVI Ay ’>’ ICOMMAND FROMPT 
CALL OUTT §SEND TO CONSOLE 
INPL2: LXI Hy IBUFF § BUFFER ADDRESS 
SHLT IBUFF INITIALIZE FOINTER 
MVI CO SINITIALIZE COUNT 
INPLIs CALL INPUTT sCHAR FROM CONSOLE 
CFI oe sCONTROL CHAR? 
JC INPLC gYESs GO FROCESS 
CFI DEL sDELETE CHAR? 
JZ INPLB 9YES 
CPI ie sa ae | sUPFER CASE? 
JC INFL3 >NO 
ANI JFH gMAKE UPPER 
INPL3$ MOV MA gFUT IN BUFFER 
MVI Av 32 sGET BUFFER SIZE 
CMP C gTEST IF FULL 
JZ INFLI gYES» LOOF 
MOV Arh SRECALL CHARACTER 
INX H ¢INCR POINTER 
INR C sAND INCR COUNT 
INPLE$ CALL OUTT §ECHO CHARACTER 
JMF INPLI §GET NEXT CHAR 


NPLC? 


a> “Gp “E> 


CFI 
JZ 

CPI 
JNZ 


CTRH 
INPLE 
CR 
INPLI 


END OF INFUT LINE 


MOV AvC 
STA IBUFC 
¥ 
§ CARRIAGE RETURN» LINE 
CRLF: MVI AryCR 
CALL OUTT 
MVI AyLF 


USE 


“SD Gr “OP “te 


REPEAT 


IF NULLS REQUIRED AFTER 


MACRO 


PROCESS CONROL CHARACTER 


9H? 
gYES 
gTEST IF RETURN 
gNO» IGNORE CHAR 


gsLINE 
’ SAVE 


COUNT 


FEED 


CRey LF 


O1FS 


C30FO1 


79 
B7 
CABCO1 
2B 

on 
3E08 
C3DA01 


ES 
2A2Z106 
SAZ306 
néoi 
DAI802 
322306 
7E 

23 
222106 
El 

Cc? 


Ch4401 
DASBOL 
EB 
Cp44o0l 
EB 
13 
ES 
Cn4401 
ES 
CHBS02 
CNB404 


CDhOO2 
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IF 
CALL 
XRA 
REPT 
CALL 
ENDM 


ENDIF 


JMP 


G} ~a> «ap ~ar «a> 


ETCHS PUSH 
LHLD 
GETC2: LDA 


GETC3Z$ INX 
SHLI 
GETC43 POP 


4 
3 
a 
3 
a 
9 
na 
3 
F 


DUMPS CALL 


PUNCH CR» 


EWREC?S CALL 


Ap ae sep 2 we ‘ap wap cae 


NNULS > O # ASSEMBLE 


OUTT 
A $GET A NULL 
_ NNULS~1 
OUTT 
>NULLS 
OUTT 


DELETE ANY FRIOR CHARACTER 


AsC “3CHAR COUNT 

A §ZERO? 

INFLI §YES 

H ¢HACK POINTER 
C §AND COUNT 


ArCTRH #BACK CURSOR 
INPLE gPRINT IT 


OBTAIN A CHARACTER FROM THE CONSOLE 
BUFFER. SET CARRY IF EMPTY. 


H ISAVE REGS 

IBUFF IGET FOINTER 
IBUFC §GET COUNT 

1 sDECR WITH CARRY 
GETC4 gNO CHARACTERS 
IBUFC SREPLACE COUNT 


Av §GET CHARACTER 

H sINCR FOINTER 
IBUFF sREFLACE POINTER 
H sRESTORE REGS 


¥CARRY IF NO CHAR. 
ee 


FUNCH A FAPER TAPE 


READHL #START ADDRESS 
ERROR #TOO0 FEW PARAM 


READHL #¢STOF ANDRESS 


i 

H 

READHL AUTOSTART ADDR 
sFUT ON STACK 

LEADR sFUNCH LEADER 

LABEL ¥FPUNCH LABEL 


START NEW RECORD» ZERO THE CHECKSUM 


2 NULLS ANDI COLON 


FPCRLF sCRye LF» NULLS 


FIND THE RECORD LENGTH 
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0234 
0235 
0236 
0237 
0238 
0239 
023A 
O23D 
O23F 
0242 
0243 
0246 
0247 
0248 
O24B 
024C 
O240 
O24F 


“0252 


0255 
0256 
0259 
025A 
O250D 
O2S5E 


 O25F 


0262 
0265 


02468 
0269 
026A 
0260 


O26E 


0271 
0272 
0273 
0275 
0278 
0279 
0270 
027F 
0282 


0285 
0286 
0288 
028B 
028C 
028F 


3E10 


04600 
Cneso2 
CH9OO2 


CHY502 
23 © 
on 
C25902 
CDé703 
C33102 


CA7902 
3C 

CDe502 
C6703 
CDESO02 
C38601 


“er 


MOV ALE COMPARE LOW STOP 
SUB L § TO LOW FOINTER 
MoV CoA @DIFFERENCE IN C 
MoV AcD sCOMFARE HIGH STOF 
SBE H $ TO HIGH POINTER 
MOV BeA SDIFFERENCE TO & 
JC ERROR IMPROPER: Hol > DvE 
MVI AryRLEN $FULL RECORD 
JNZ NEW? 
CMP C COMPARE TO E~-L 
JC NEW2 sFULL RECORD LENGTH 
| MOV Ask SARE BOTH E~-L AND 
* ORA C § D-E ZERO? 
JZ DONE $YES» REC LENGTH = 0 
MOV Ast SHORT RECORD 
NEW23; MOY CoA RECORD LENGTH TO C 
MVI BrO sZERO THE CHECKSUM 
CALL FNHEX #FUNCH RECORD LENGTH 
CALL PUNHL = §PUNCH H/L 
XRA A 
CALL FNHEX  #PUNCH RECORD TYFE 0 
FMEM3 MOV AsM | 
CALL FNHEX  #FPUNCH MEMORY BYTE 
INX H ¢@INCR. MEMORY FOINTER 
DCR Cc sDECR RECORD LENGTH 
JNZ FMEM 
CALL CSUM SFUNCH CHECKSUM 
JMF NEWREC NEXT RECORD 
? 
* FINISHED, PUNCH LAST RECORD, RECORD 
$ LENGTH 00» THE START ADIRESS> 
* AND A RECORD TYPE OF O14 
? 
DONE?  XRA A 
MOV BoA sZERO CHECKSUM 
CALL FPNHEX  #ZERO RECORD LEN. 
POF H 
CALL PUNHL  #AUTOSTART H/L 
MoV AsH sCHECK FOR 
ORA L § AUTOSTART 
MVI Ard $0 WITH CARRY 
JZ DON2 NO AUTOSTART 
INK A 
NON2: CALL PNHEX $RECORD TYFE 1 
CALL CSUM $PUNCH CHECKSUM 
CALL LEADR  #FUNCH TRAILER 
JMP RSTRT i #NEXT JOB 
¥ 
# PUNCH BLANK HEADER AND TRAILER 
9 
LEADR: XRA A 
MVI B40 sTAFE NULLS 
NLDR3 = CALL FOUT 
DCR B 
JNZ NLDR 
RET 


0290 
0291 
0294 


0295 
0296 
0297 
0293 
0299 
029A 
O29B 
O29C 
o29n 
O29E 
O2Al 


O2A2 
O2A4 
O2AG 
O2A7 
O2AP 
O2AA 


O2ZATI 
O2B0 
O282 
O2B4 
O2B5 
02B7 


0288 
O2B9 
O2BB 
O2BD 
0200 
0201 
0203 


0204 
0206 
0208 
O2CR 
o2CH 
O2CF 


7C 
CH9YS02 
7D 
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FUNCH THE Hel REGISTER FAIR 


3 
3 
FUNHL: MOV 
CALL 


MOV 


AgsH 
FNHEX 
AeL 


3 

¢ CONVERT A BINARY 
¢ CHARACTERS» 
3 
F 


"NHEX$ FUSH FSW 
ADD RB 
NOV ByA 
FOF FSW 
PUSH FSW 
RAR 
RAR 
RAR 
RAR 
CALL PHEX1 
FOF FSW 
9 
§ FUNCH A HEX CHARACTER 
¢§ LOWER FOUR BITS 
3 
PHEX1: ANI OFH 
ALT 144 
DAA 
ACT 64 
AA 
JMP FOUT 
9 
3 INFUT A HEX CHARACTER 
7 
HEX; CALL FIN 
Sur “QO! 
CPI 10 
RC 
SUI 7 
RET 


OUTPUT A BYTE 


FUNCH THEMs 


*FETCH H 
3PUNCH IT 
sGET Ly» PUNCH IT 


NUMBER TO TWO HEX 


Abn TO CHECKSUM 


¥SAVE ON STACK — 
sADD TO CHECKSUM. 


sSAVE IT IN B 
yRETRIEVE BYTE 


sROTATE UPPER 


f 
?TO LOWER 
SLEFT CHARACTER 
3RIGHT CHARACTER 


FROM 


¢MASK UPPER 4 BITS 


FROM TAPE 


TO THE FUNCH 


POUT: PUSH PSW 

POUTW: IN PSTAT 
ANT FOMSK 
JNZ POUTW 
FOF FSW 
OUT FLATA 
RET 

? 

$ INPUT A BYTE FROM PAPER TAPE 

? 

FIN: IN PSTAT 
ANI PINSK 
JINZ FIN 
IN FOATA 
ANI 7FH 


“a> 


sSTRIP FARITY 
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PUNCH CR» LF» NULLS AND COLON 


a 
? 
7 
y 


O200 SEOD PCRLFS MMVI. ArCR 
0202 CUBBO2 CALL FOUT 
0205 3EOA MVI AvLF 
0207 CDBBO2 CALL FOUT 
O2DA AF XRA a 
O2DB CDB802 CALL FOUT §TWO NULLS 
O2nE CUBBO0O2 CALL FOUT 
O2ZE1 SESA MVI As’ 3? >COLON 
O2ZE3 C3B802 JMP FOUT 
2 
§ ENTRY FOR LOAD» EXECUTE AND VERIFY 
gy 
O2ZE6 320006 FLOADS STA TASK 
O2E9 3E11 MVI Ari? *TAPE REATER ON 
O2ER CDB8O2 CALL FOUT 
O2EE CD44Ol CALL READHL sOFFSET 
O2F1 2201046 SHLD OF SET gSAVE IT 
: ¢ FROCESS THE RECORD HEADING ON INPUT 
y 
O2F4 CDC402 HEAD: CALL PIN sINPUT FROM TAPE 
02F7 FESA CPI nee § COLON? 
O2F9 C2F402 JINZ HEAD §5NO» TRY AGAIN 
- O2FC 04600 MVI ByO ZERO THE CHECKSUM 
O2FE CD3303 CALL PHEX sRECORD LENGTH 
0301 B?7 ORA A 9IS IT ZERO? 
0302 CA4403 JZ ENDFL gYES» DONE 
0305 4F MOV CvrA ySAVE REC. LEN. 
0306 CD2B03 CALL TAPEHL §GET H/L 
0309 EB XCHG PADDR TO NeE 
O3OA 2A0106 LHLD OF SET sGET OFFSET 
O30n 19 DAD D SADT 
O30E C3303 LOOP: CALL F'HE X gINFUT TATA BYTE 
O311 SF MOV EvA gSAVE BYTE 
0312 3A0006 LDA TASK 9GET TASK 
0315 FES6 CPI “We sSEE IF VERIFYING 
0317 7B MOV AvE MOVE BACK 
0318 CA1COS JZ SKIP ¢JUMP IF VERIFYING 
O31B 77 MOV MA sDATA TO MEMORY 
O31C BE SKIF 3 CMP i sCHECK MEMORY 
| O31D C27603 JINZ MERROR BAD MEMORY 
0320 23 INX H PINCREMENT FOINTER 
0321 OD NCR C sDECK RECORD LEN 
0322 C20E03 JNZ LOOF gNOT YET ZERO 
0325 Cpénos CALL CHECK gFROCESS CHECKSUM 
0328 C3F402 JMP HEAD ISTART NEXT RECORD 


INPUT Hel AND RECORD TYPE FROM TAPE 


an] “I> “a> “a> 


O32B CH3I0S APEHL: CALL FHEX yREAD H 

O3S2E 67 MOV Hea 

O32F CD3303 CALL PHEX gREAD L 

0332 6F : MOV Lea sREAD RECORD TYPE 


; 
’ CONVERT 2 CHAR FROM TAFE TO ONE BINARY 
§ WORD, STORE IN A AND ADD TO CHECKSUM 


CUADOZ 


oF 


CL2B03 
FS 


CDI303 
CH6203 


C38601 


S$E13 
C3BB802 


78 
2F 
3C 
C39502 


CN3303 


CD6203 


PAPER TAPE AND 


PHEX; CALL 


ROUTINE TO CHE 
NOFL$ CALL 


TURN OFF TAFE 


mel “Op Wd “as 


OFF 3 MVI 
JP 


CALCULATE AND 


OC} war wo ar 


SUMs MOV 
CMA 
INR 
JMPF 


SEE IF CHECKSU 


CJ vee ap -as 


HECK? CALL 
XRA 


o> SO 
‘a> J 


a> 
a> 
“ED 
<> 
xc> 
“ap 
“aD 


ERROR MESSAGES 


Gd “Ss “Gb “Oo 


MERROR? MVI 
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HE X sUFPER CHARACTER 


*MOVE TO UFFER 


3HALF 

EvA gSAVE IT 
HEX JLOWER CHARACTER 
E sCOMBINE BOTH 
E»vA §SAVE IT 

B sADD TO CHECKSUM 
BoA *SAVE IT 

AYE *RETRIEVE DATA 


CK FOR AUTOSTART 


TAPEHL AUTOSTART ADDRESS 
sAND RECORD TYPE 


FSW sSAVE RECORD TYPE 
PHEX ¢INFUT CHECKSUM 
TOFF sTAPE READER OFF 
FSW gRETRIEVE REC TYPE 
1 §AUTOSTARTT 

RSTRT >NO 

TASK §CHECK TASK 

a sEXECUTE? 


JPCHL sYES» GO THERE 
OUTHL gNO» PRINT HL 
RSTRT gNEXT TASK 
REALER 


Avl? 
POUT 


PUNCH THE CHECKSUM 


AvB sCHECKSUM TO A 
sONE’S COMPLEMENT 
A #TWO’S COMPLEMENT 


PNHEX 3PUNCH CHECKSUM 


M IS CORRECT (ZERO) 


PHEX SINFUT CHECKSUM © 

A 

B #IS CHECKSUM ZERO? 
¥YES» RETURN 

SSPF TPP PST PR SRS R RPT R ERR TER EG 


As ’C’ sCHECKSUM ERROR 
1 7DB TRICK TO SKIP. 
As “MN 3@ FOR BAD MEMORY 


 TOFF STAPE READER OFF 
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037C 
0370 
0380 
0383 


0386 
0388 
OS9E 
O3AI 
O3BS 
03B7 
O3D0 
0302 
O3SER 
O3ED 
0407 
0409 
0420 
0429 
0430 
O44F 
0448 


O46B 
0481 


Fi 
CDOFO1 
CDIBOI 
C38601 

? 
ODOA SIGN? 
48465782070 
ODOAO0A 
4$202H206C 
ODOA 
4720202067 
ODOA 
9220202072 
ODOA 
2020202028 
ODOA 
9620202076 
206065606F 


9720202077 


2028616E44 
2877697468 
ODOA0D 


ODOA4SSGE 7 4LMESG¢ 
OnOADO 


FUNCH 


ap “GD “ae 


LABEL? 


LABL1: 


NEXTC? 


CDB802 
C38F04 


FOP PSwW 

CALL QUTT SFRINT ERROR TYPE 
CALL OUTHL SPRINT H/L . 

JMF RSTRT 

DB CReLF 

Da ‘Hex Parer-tare rrodram’ 

DR CRe LF oy LF 

DE ‘E - load and execute’ 

DB CReLF 

DB ‘G ~- do to addresses sdiven’ 
ng CReLF 

DB “R ~ read tare into memory’ 
OB CReLF 

DB : (with ortional offset)’ 
DB CReLF 

DB "YY ~- verify tare adainst’ 
QR ’ memory’ sCRe LF 

DE ‘W- write Pparer tare’ 

DE ’ (and label)’ sCReLFs ’ 7 
OB ‘<with optional autostart) ’ 
DB CReLF ed 

DB CRelFs ‘Enter lesder message’ 
DB CReLFrO 


READABLE LABELS 


PUSH Ho 
FUSH a) 

LXI Dy LMESG 
CALL SENIUM 
CALL. INPLWN 
CALL GETCH 
JC LABL2 
SBI 20H 
JC LABLI 
CPI 63 
JNC LABL1 
MOV Lea 
NOV Era 
MVI Hed 
MVI DO 
DAD H 

DAD H 

DAD D 
XCHG 

LXI H» TABL 
BAD D 

MVI CS 
MOV ArM 
CALL FOUT 
INX H 

nCR C 

JINZ NEXTC 
XRA A 
CALL POUT 
JMF LABL A 


ON FAFER TAFE 


sLABEL MESS. 
sSEND IT 

sGET A LINE 
sGET CHARACTER 
sDONE ON CARRY 
sASCIT BIAS 

9% SPACE 


9T00 BIG 


sHOUBLE IT 
9TIMES 4 
¢TIMES FIVE 


FNEXT CHARACTER 


RNR CLLRS TSAR eee SSSinASeNSsteee entireties tsnanninenememernhtnittaieommmmanstsonast 
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CRS8S02 
Di 
El 
Cc? 
5 
QOOOOOOOO0OTABL ¢ 
OOOOCFCFOO 
0007000700 
20FE28FE28 
4&89FF 8972 
4626100804 
6C92AT4OAO0 
0004030300 
003C 428100 
0081423000 
8850F 85088 
08087E0808 
0080703000 
0808080808 
00C0C00000 
4020100804 
7EALB9BS7E 
8482FF 8080 
C2A1918986 
4289898976 
OCOABOFFSS 
6789898971 
7EBIBIBI72 
O101F 90503 
7689898976 
46898989 7E 
00D8D80000 
0080763600 
1028448200 
2828282828 
8244281000 
0601890906 
7EBLIODIIOE 
FEOSO9O9FE 
B81FFB9B976 
7E81818142 
B1FFS1817E 
FF 89898989 
FFO?090901 
7E81919172 
FF O80808FF 
OO81FF8100 
6080817F O01 
FFO81422C1 
FF 80808080 
FFO20CO2FF 
FFO23C40FF 
FF8i8i81FF 
0509090906 
7ESLALA4ALBE 
FFI9294986 
4689898972 
OLOIFFO101 


LABL2; 


CALL 
FOP 


LEADR 


Or Or Ov» Oy QO 
Oe Ov 207920770 
Or Fe OQ Fe» Q 
2542409 254240 
1372925591379114 
7Oe 38s 16% 20091946 
10891467172964? 160 
Ov» 4 39 3» 9Q 
Ov G&0Or &469129% 0 
QO» 1299669 &0% 0 
134980: 248780" 136 
8» 8s 12678» 
Or 1289112248 O 
8» 8s Gs 8s 8 
O» L192°91P290e 0 
649 32s lbs By» 
126916149137 9133 29126 
1329130925591289128 
19491 db1 LAS 91379134 
669 137°913729137°118 
12s 109137592559136 
10391379137 91379113 
12469137913791379114 
ley le 249 Sy F 
118°237913791379118 
7Oe 13771379137 2126 
Ov 216921690» 90 
Or 128°118954- 0 
16> 40» 6&8» 13070 
409 40% 402 4G» 40 
1309468» 40% ié» 0 
Ge Ly 18599? & 
1249129 91572145914 
254999 Py Pe» 254 
129 225591379137%7118 
1246912991299129% &6 
12922559129 %129 9126 
2909713579137 91379137 
20909Fy FP 9F ol 
1269129914591459114 
25598» 8° 8s 255 
Oe 1295255912990 
92 1289129912721 
255989 209 34% 193 
2559128 21287128%7128 
2595929 129 2» 255 
255927 &0° 64% 255 
2559129 912991292255 
Se Pe Pe Pe & 
12621299161945» 190 
2559259 417 73% 134 
7Oe 137 2913721379114 
le ds 2PSS5eis 1 


33) 


> 


Sh GS WP Gb > “SP GS “GP We WO “Gd “Gh “ED “Op sap wD wD GP “Gb “Gb “Gh SGD “GP “E> “OP WP WO Ge Wr “SD “Ge “GR MED “GD NED “ED “I> “GD “Gb “GD “GD “UP “ED “Gh SID “GD “GP we “Gm «ap ~ap “ae “ae 


AN Bo vwoc@xerPrAces ITH nmMownwseyp 
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OSCE 
OSD3 
OSD8 
OSDD 
OSE2 
OSE7 


OSEC 


OSFi 
OSF6 
OSFB 


04600 
0601 
0603 


0621 
0623 
0624 


0638 


7F8080807F 
OF Z0COSO0F 
7F8070807F 
C3241824C3 
O304F 80403 
C1A1918987 
OOFF818181 
0408102040 
B818181F FOO 
0C0201020C 


0000 


Symbols 3 


oo1i1 
0170 
0367 
02468 
0214 
0129 
0621 
O1EO 
0103 
O4BF 
OSOE 
O4AF 
0601 
0110 
O2A2 
O2ZES 
O2B8 
0149 
0010 


~~ O31C 


O32B 


CDATA 
CONTIN 
CSUN 
DONE 
GETCS 
HEX1 
IBUFP 
INPLC 
INPUTT 
LABL2 
LOOF 
NEXTC 
OF SET 
OUTW 
PHEX1 
PLOAD 
POUT 
RDHL2 
RLEN 
SKIP 
TAPEHL 


TASK: 
OFSET: 


STACK? 
IBUFP 3 
IBUFC? 
IBUFF ¢ 


La 


O36 
ooon 
0008 
0344 
0218 
O2An 
O1B4 
O1nA 
O1AB 
0285 
0376 
0134 
O118 
O2n0 
0333 
0259 
0289 
O1SE 
0186 
- 0621 
0600 


CHECK 
CR 
CTRH 
ENDFL 
GETC4 
HEX 
INPL2 
INPLE 
JPCHL 
LEADR 
MERROR 
NIR 
OUTHL 
PCRLF 
PHEX 
PMEM 
POUTW 
RDHL4 
RSTRT 
STACK 
TASK 


1279128912891289127 3 U 

IS* 48° 192948» 15 ¢ V 

127 °128911291289127 3 W 

19S%369 24» 195 3 X 

3s Ay 24894 93 a 6 

1939161 914591379135 ¢ Z 

Ov 25591299129 °129 6 C 

4&y Gy 1é>s 64 6 \N 

12991299129 225590 $ J 

125 2» is 12 3 7 

i sSAVE IT 

0 sLOAD OFFSET 

30 SSTACK SPACE 

2 SBUFFER POINTER 

1 sBUFFER COUNT 

20 INPUT BUFFER 
0001 CIMSK 0002 COMSK 
O1EE CRLF 0010 CSTAT 
OO7F REL 02797 DON2 
O16B ERROR 0208 GETC2 
0204 GETCH O2F4 HEAD 
0623 IBUFC 0624 IBUFF 
QO1B0 INFL3Z O1F8 INPFLE 
O1BC INPLI O1AC INPLN 
0484 LABEL O48F LABLI 
OOOA LF O44B LMESG 
024C NEW? 0231 NEWREC 
0288 NLDR 0000 NNULS 
0120 OUTHX O10F OQUTT 
0007 FRATA O21A FOUMP 
6001 FINSK O2C4 PIN 
0295 PNHEX 0080 FOMSK 
0006 FSTAT 0290 PUNHL 
0168 RDHLS 0144 READHL 
0173 SENDM 0386 SIGN 
0100 START 04C5 TABL 
0362 TOFF 
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This program generates tapes with a modified Intel format. A typical 
record is shown in Figure 9.1. 


—— record header (colon 


record length (2 characters) 


address (4 characters) 


record type 00 or 01 


“data bytes “Wh checksum (2 characters) 


: 10010000C37D01DB10E601CA0301DB11E67FC9F5FF 
Figure 9.1. The hex tape format. 


In this example, the record length is 10 hex, the address is 100 hex, the 
record type is 00, the first data byte is C3, the last data byte is F5 hex, and 
the checksum is FF hex. This is the format used by the CP/M assemblers 
ASM and MAC to generate HEX files. 

Each record starts with a colon and is followed by the hex-encoded 
data. Since the data are encoded in ASCII, two bytes on the tape are needed 
to represent each original byte. Two hex characters, representing the record 
length, follow the header character. This hex value gives the actual number 
of data bytes contained in the record. It does not include the other characters 
in the record which designate the record address, the record type, and the 
checksum. A zero value for the record length is used for the last record to 
indicate the end of the file. 

The record address, the address of the first byte in the record, comes 
next. This address is encoded into four hex characters, high-order byte first. 
The next item is the record type; it consists of two characters and can be 00 
or 01. The value is usually 00, however; 01 is used for the end-of-file record 
for autostart tapes. 

The data from memory are encoded next. Two bytes on the tape repre- 
sent each data byte. The checksum byte is the last item in the record. It is 
formed by taking the two’s complement of the sum of all the previous bytes 
in the record (in binary form). A carriage return, line feed, and optional 
nulls follow the checksum. 

When the hex tape is loaded into the computer, the bytes within each 
record including the checksum are added together. The checksum byte is 
formed from the two’s complement of the original sum. Since the sum ofa 
number and its two’s complement is zero, the total at this point should be 
zero. A nonzero result indicates an error. 

The last record in the file has a record length of zero. This end-of-file 
record can indicate an autostart address in place of the usual record address. 
The computer can branch to this autostart address after the program is 
loaded. The record type in this case is 01—the end-of-file record. 
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Since the tape is written with an ASCII-encoded format, it is easy to 
read. Listing 9.2 shows the first part of the monitor made with the monitor 
itself. 


Listing 9.2 €& hex dump of the bedginning of the monitor. 


sLOOLOQOOCS7DOLDBLIOE S6OICAOSOIDBIIES7FCOFSFF 
SLOOLLIOOODBIOES6O2ZCALOOIF INS1LICS4CC02001 40n0C 
210012000791 FIFLFIFCO2901 79ES6OFCE9027CE40EA 
$1001300027C30F01NG630NBFE173F DBFEOASFNONGCE 


The disadvantage of this format is that the tape takes twice as long to 
make and twice as long to read as a corresponding binary tape. A BASIC 
interpreter that loads in 20 minutes from a binary format would take 40 
minutes to load from hex format. 

You may want to reassemble the hex tape routine for some other 
memory location, or you may want to incorporate it into your system 
monitor. But wait until you’ve learned about the binary tape monitor shown 
later in this chapter before you do. 

Type in the hex program, assemble it, and start it up by branching to the 
beginning. A list of commands will be printed as a guide to operation. 


Hex paper-tape program: 


load and execute 

go to address given 

read tape into memory (with optional offset) 
verify tape against memory 

write and label paper tape (with optional autostart) 


s<70o 


Console input is buffered just as it is in our system monitor. In fact, you will 
notice that many of the monitor I/O routines have been duplicated in this 
tape program. To create a tape, type the letter W (for write), the start 
address, and an optional autostart address. Finish the line with a carriage 
return. Typing errors can be corrected as usual with a DEL or backspace 
key. When the statement “Enter leader message”’ appears, either type the 
characters that you want on the tape leader, or just type a carriage return to 
skip the title. 

After the tape has been made, it should be verified. Type the letter V 
and a carriage return. If you have a Teletype with an automatic tape reader, 
the computer can turn it on at the beginning and turn it off at the end. This 
is accomplished by sending a control-Q at the beginning and a control-S at 
the end. Each entry on the tape will be compared to the corresponding value 
in memory. If a checksum or verify error is detected, the process will be 
terminated. The appropriate error message and the address of the error will 
appear. In the case of a checksum error, the address is not meaningful. 

A tape can be loaded into memory by typing the letter R (for read) and 
the optional offset value. This offset is added to the record address, after the 
record address has been added into the checksum. An offset of 1000 hex will 
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load a program 4K bytes higher than the regular address. An offset of FOOO 
hex will load the program 4K bytes lower. If you want, the computer will 
branch to the autostart address after the tape has been loaded; simply type 
an E (for execute) rather than an R. 

If a leader message has been punched on the tape, it is not necessary to 
position the tape past this message. The loader routine is looking for a colon 
to indicate the start of a record. But the colon symbol will never appear in 
the label itself. There is a GO command so that you can easily leave the tape 
program. Type the letter G (GO) and the address. 


A TAPE-LABELING ROUTINE 


The assembly language instructions. that punch readable labels on paper tape 
begin at LABEL and continue on down to TABL. The data used by this por- 
tion starts at TABL and goes down to TASK. The characters that are avail- 
able include the complete set of ASCII characters from the blank (20 hex) 
through the underline (5F hex). The uppercase letters are included but the © 
lowercase letters are not. One line of data in the source program is used for 
each character punched on the tape. The characters can be identified by the 
comment at the end of the line. The lines of data are arranged in sequence 
corresponding to the ASCII character set. The characters punched on the 
tape are generated in a five-by-eight matrix, with a row of blanks between 
the characters. 

When the label subroutine is called, it first prints a message requesting 
input. In response, the user enters one line of characters and concludes the 
line with a carriage return. The message is then punched on the tape. Each 
ASCII character is obtained from the console input buffer as needed. The 
ASCII character is converted to binary by subtraction of an ASCII blank. 
The result is then used as a pointer to find the corresponding entry in the 
table. This is done by multiplying the binary value by 5 and adding it to the — 
table address. The next five bytes of the table are then sent to the punch. 
The complete set of characters is shown in Figure 9.2. 


Figure 9.2. The set of letters and numbers produced by HEXMON. 
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The label subroutine with its necessary I/O routines can be removed 
from the tape program and used separately. It can be placed into high mem- 
ory and called by another program such as a BASIC interpreter. 


A BINARY TAPE MONITOR 


The hexadecimal program given in the previous section is useful for paper 
tape. But a binary tape routine is much more suitable for magnetic tape. 
With a magnetic tape format, the tape cannot be visually inspected. There- 
fore, there is no advantage in coding the data in hexadecimal format. 

Files are organized into records just as they are with the hex program. 
Each record starts with a record header, then continues with the record 
length, the address, the data, and the checksum. But the binary format is a 
bit different. As shown in Figure 9.3, there are three types of records: a 
header record, a data record, and an end-of-file record. The first record in 
the file is the file-header record. It begins with a 55-hex character. An 
optional filename appears next. The record header ends with a carriage- 
return character. 


Header Record | 55H | Filename | Carriage Return | 
Data Record | 3CH | Rec. Len. | Addr. | Data | Checksum | 


‘ EOF Record | 74H | Autostart Addr. | Checksum | 


Figure 9.3. Three different record types are used with the binary tape 
format: A header record, one or more data records, and an 
end-of-file record. 


The data record follows the header record. It starts with a 3C-hex 
header byte, a record-length byte, and two bytes giving the record address. 
The record address is written with the low-order byte first. The data bytes 
appear next, and then the checksum concludes the record. 

With this format, the checksum byte consists of the sum of the data 
record bytes rather than the two’s complement of the sum as used with the 
hex format. This checksum includes the record address and the data bytes, 
but it does not include the record length. The record length is not needed, 
since an incorrectly read record length will point to an incorrect byte that is 
to be used for the checksum. 

? The end-of-file record is four bytes long. It begins with a 74-hex char- 
acter. It is followed by the autostart address, written as low byte, high byte. 
The fourth byte in this record is the checksum of the two-byte autostart 
address. 

The routine given in Listing 9.3 is not a complete program. It is meant 
to be added to the end of the system monitor developed in Chapter 6. The 
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I/O and conversion routines of the monitor are used whenever possible. If 
you want to use it as a stand-alone program, you will have to include the 
necessary I/O routines. The addition of the tape program to the monitor will 
increase its size to one-and-a-half K bytes. 

Add the new instructions to the end of the monitor, then change the 
monitor command-branch table for the letter T (tape) 


nw TAPE $T 
so that a command line starting with the letter T will cause a branch to the 


new tape routines. 


Listing 9.3. Binary tare routines. 


’ LOCATIONS IN THE STACK AREA 


? 
§706 = F BUF EQU IBUFF+32 $FILENAME BUFF 
57E6 = OFSET EQU FRUF+20H #LOAD OFFSET 
S7E8 = TASK Eau OFSET+2 
S7E9 = LFLAG Eau TASK+1 #LOAD-ERROR FLAG 

9 
0055 = SBYTE EQU SSH $SYNC BYTE 
0030 = RHEAD  EQU 3CH #RECORD HEADER 
0074 = EOF EQU 74H SEND OF FILE 

3 
0006 = PSTAT  EQU é $PUNCH STATUS 
0007 = FDATA EQU FPSTAT+1 #PUNCH DATA 
0001 = PIMSK  EQU 1 SINFUT MASK 
0080 = POMSK EQU 80H SOUTPUT MASK 

+7 

; 
SEFA 210000 TAPES = -LXI HO | 
SBF) 22E657 SHLD OFSET  #ZERO OFFSET 
§COO CN2559 CALL GETCH  $COMMAND 

9 

$ TAFE-COMMAND) PROCESSOR 

? 
5CO3 FE4S CPI ‘ES 
5COS CAD25C JZ TLOAD #LOAD AND EXEC 
§CO8 FEAC CFI ie 
SCOA CAD2Z5C JZ TLOAD = sLOan 
SCOD FE4D | CPI oy! 
SCOF CAS8OSD JZ TMAKE  $MAKE TEST TAPE 
SC1i2 FE4F CFI ‘0’ - 
§C14 CACASC JZ OFFST  ‘#OFFSET Loan 
5C17 FES4 CFI ‘Ts 
§C1i9 CAAT JZ TTEST  $#TAPE TEST 
5C1IC FES CPI *ye 
SCIE CAD25C JZ TLOAD #VERIFY TAFE/MEM 
§C21 FE44 CPI a $DUMP TO TAPE 


8C23 C2D459 JNZ ERROR 


Se 
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DUMP MEMORY TO TAPE IN 8-BIT BINARY FORMAT 


S> “a> 


SC26 CDB4659 CALL ROHLDE ADDRESS LIMITS 
NC29 ES FUSH H gSTART ADDR 
SC2A COEDS? CALL READHL sAUTOSTART 

SsC2n E3 XTHL sSWITCH WITH Hel 
SC2E CN885c CALL LEADR ¢TAPE LEADER 
8031 3E55 MVI AsSBYTE sSYNC RYTE 

YC33 CO9SSC CALL TOUT 

9C36 CD2559 TOMP : CALL GETCH sFILE-NAME CHAR 
YC39 DA4a2Z5C JIC PDA sFILENAME END 
SC3C CHessc CALL TOUT sSEND TO TAPE 
SC3F C3365C JMF TOMP gNEXT CHAR 

3C42 3E00 | PDAs MVI ACR 

9C44 COSSsc CALL TOUT eFUT CR ON TAPE 
SC47 SE3C FIO MVI AsRHEAD #RECORD HEADER 
sC49 CUP3ZSC CALL TOUT sPUT ON TAPE 
JC4C 7B MOY AvE 

C40 9S SUR L 

SC4E 3C INR A *RECORD LENGTH 
SC4F 4F MOV Cra 

VCS0O CO93SC CALL TOUT gFUT ON TAPE 
SCS3 70 . MOV AvL 

9CS4 CO93SC . CALL TOUT gL TO TAFE 

SCS7 45 MOV Bel ySTART CHECKSUM 
SCS8 7C MOV ArH 

9CS59 CD9SSC CALL TOUT gH TO TAFE 

SCSC 7E POI MOV Ari sGET DATA 

VCSD CD9SSC CALL TOUT jSEND TO TAFE 
53C60 OD | DCR Cc sRECORD COUNT 
SC61 CA685C JZ PD §’ DONE 

SC64 23 INX H sRUMP POINTER 
8C65 C3SCSC JMF Pod gNEXT BYTE 


END OF RECORD 


“Ti as sap sar 


3C68 78 23 MOV AvB *GET CHECKSUM 
8C69 CH93SC CALL TOUT sSEND IT 
sC46C 7C MOV AvH 
SC6D BA CMF fh gEND OF FILE? 
SC6E CA75S5SC JZ FOS 9YES 
SC71 23 INX H 
yC72 C3475C JMF FLO SNEXT RECORD 
? 
§ END OF FILE 
P 
SC75 3E74 Fuss MVI Av EOF 
~C77 CD93SC CALL TOUT sSEND IT 
JC7A Et FOF H sAUTOSTART ADDR 
SC7B 7D MOV AvyL yLOW 
SC7C CH935C CALL TOUT gSEND IT 
SC7F 45 MOV Bel gSTART CHECKSUM 
3C80 7C MOV AvH jHIGH 
YC81 CN935C CALL TOUT sSEND IT 
3C84 78 MOV AgR § CHECKSUM 
SC85 CH9S3SC CALL TOUT sSEND IT 


AF 
0648 
CHPSSC 
05 
C28BSC 
C9? 


CDB25C 
FS 
80 
47 
Fi 


C2B25C 
LBO?7 
Cc? 


" 
5 
a 
5 
a 
3 
L. 
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MAKE A LEABER/TRAILER ON TAPE 


EADRs XRA A sGET A NULL 
MVI By 72 9% OF NULLS 
NLR CALL TOUT sSEND NULL 
DCR B 
JNZ NLOR 
RET 


a 
? 
a 
g 
a 
y 
T 


OUTPUT BYTE TO TAFEs ADI TO CHECKSUM 


OUT: PUSH FSW 


Abn B §TO CHECKSUM 
MOV BeA gFUT BACK 
FOF FSW 

FOUT: PUSH FSW 

FOUTW? IN FSTAT ISTATUS 
ANI FOMSK 

$ : 

§ NEXT LINE MAY NEED TO BE JZ FOUTW 
JNZ FOUTW yNOT READY 
FOF FSW 
OUT FOATA ySEND BYTE 
RET 


of “a> aD “a> “GD 


a> “2h “Ge 


INFUT BYTE FROM TAFE 
ADD TO CHECKSUM 


INAS CALL PIN sGET BYTE 
FUSH FSW 
AUD B sADD TO CHECKSUM 
MOV ByA sFUT BACK 
FOF FSW 


SEND TO CONSOLE IF NOT A CONROL CHARACTER 


ANI 7FH 
CFI ee 
RC $ CONTROL 
OUT ‘CDATA 
RET : 

¥ 

PIN? IN FSTAT  $STATUS 
ANI PIMSK 

? : 

} NEXT LINE MAY NEED TO BE JZ FIN 
JNZ PIN $NOT READY 
IN FOATA  #GET BYTE 
RET KEEP § BITS 


i> “G> “EP 


LOOK FOR HEABER ON FAFER TAPE 


208 


SCBC 
SCBE 
vCC1 
vCC4 
SCCS 
SCC9 


SCCA 
SCCB 
wCCE 
Scp.l 


9C02 
SCHS 
2CD8 
vCn? 
sCaC 
SCOF 
SCE2 
SCES 
SCE4 
JCE7 
NCEP 
SCEC 
JCEF 
SCFe 
SCFS 
SCFS 
SCFS 


JCFRB 
JCFE 
SCFF 
SDOO 
s002 
—~§pos 
SD06 
3DO7 


SDOA 
snoc 
SDOF 
obie2 
9D13 
5D14 
Snis 
3D18 
Sb19 


SE11 
Cue7SC 
COUB2SC 
FESS 
C2cisc 
C9 


37 
CD9NS? 
22E657 
7A 


S2E857 
210657 


FEOD 
CAICSD 
L1A657 


CHASSC 


3AE9S?7 
B?7 
c2cosp 
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PIN4S MMVI ArCTRQ $7Q 
CALL POUT $TURN ON READER 
PINS! CALL FIN $GET BYTE 
CI SRYTE  #SYNC BYTE? 
JNZ PINS 3NOv TRY AGAIN 
RET 
y 
$ LOAD A TAPE WITH 16-BIT OFFEST 
9 
OFFST? MOV vA $SAVE TASK 
CALL READHL GET OFFSET 
SHLD OFSET  $SAVE IT 
MOV AyD $RESTORE TASK 
bd : 
$ LOAD/ VERIFY BINARY TAFE 
y 
TLOALS STA TASK $SAVE COMMAND 
LXI HyFBUF $FILENAME BUFFER 
XRA A $GET A ZERO 
STA LFLAG RESET FLAG 
TLOAS == CALL GETCH READ FILENAME 
JC TLDS SEND OF FILENAME 
MoV MrA $PUT IN FRUF 
INX H 
JMP TLOA #NEXT CHARACTER 
TLOS! = MVI AyCR 
STA I BUFF 
CALL PIN4 SFIND HEADER 
LXI HsFBUF #FILENAME BUFFER 
MOV AyM 31ST CHARACTER 
CPI CR 
JZ TLO $NO FILENAME 
LXI DyIBUFF $INFUT BUFFER 
ta 
$ INPUT FILENAME FROM TAPE» FUT IN IBUF 
? 
TLD2: CALL TIN4 $BYTE FROM TAPE 
STAX rt $PUT IN LRUFF 
INX 0 
CFI CR 
Jz TLD 3NO FILENEME 
CMF M sCOMF FILENAMES 
INX H 
JZ TLD2 $NEXT CHARACTER 
FILENAME ENTERED FROM CONSOLE 


a> “QP “Q> “ae 


TLO4s 


DOESN’T MATCH NAME ON 


NVI Ay “F* 
STA LFLAG 
JMP TLO2 
XRA A 

DCX D 
STAX D 

LOA LFLAG 
ORA A 

JNZ FNERR 


TAPE 
gSET ERROR FLAG 


gCHECK FLAG 
§ ZERO? 
gFILENAME ERROR 
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YD1IC CHASSC TLOS CALL TINA sBYTE FROM TAFE 
JDIF FE74 CFI EOF 

wD21 CA605D JZ EXEC §’ NONE 

8024 FESC CFI RHEAD sRECORD HEADER 
yN26 C21CSD JINZ TLO sTRY AGAIN . 
2029 CDASSC CALL TIN4 #RECORD LENGTH 
w02C 4F MOV CrA sFUT IN C 

3020 CHASSC CALL TINA PADDRe LOW BYTE 
3030 SF MOV EsA gINTO E 

SNSi 47 MOV Bea sPUT IN CHECKSUM 
9032 CHASSC CALL TINA sADDR» HIGH BYTE 
wD3S 37 MOV vA sINTO D 

936 2AE65S7 LHLD OF SET §GET LOAD OFFSET 
uDS? 19 DAD n sADD TO ADDRESS 
YNSA SAEBS7 LIA TASK sGET TASK 

onS0 S7 MOV Dea sPUT IN OD 

SDSE CBASSC This CALL TINA sDATA BYTE 

vt4l SF MOV EsAé gSAVE IN E 

s042 7A MOV AyD sCHECK THE TASK 
S043 FES6 CFI “ye ’ VERIFYING? 

~D4S 7B MOV AvE *GET BYTE AGAIN 
3046 CA4ASD JZ SKIF SVERIFYINGs SKIP 
wD4a9 77 MOV MA ?INTO MEMORY 
SD4A BE SKIP? CMF M 31S IT THERE? 
SD4B C2AESD JNZ FERROR #NO 

VD4E 23 INX H sINCR ANDRESS 
vOAF On NCR 8 C sRECORD COUNT 
SNSO C23ESD JINZ TL1 gNEXT BYTE 


END OF RECORD», GET CHECKSUM 


> “> “ID 


S053 48 MOV CoB sCHECKSUM TO C 
2054 COASSC CALL TINA sTAPE CHECKSUM 
Y0S7 BY CMF C 9THE SAME? 
0158 CAICSE JZ TLO §YES 

SDSB 3E43 CSERR: WMVI Ar ’C* sERROR 

sUSO C3455A JMPF ERR2 


END OF TAPEs GET AUTOSTART ADDRESS 
SEE IF EXECUTING 


FT] war ar ce wae 


“D600 CBASSC XEC? CALL TIN4 ISTART» LOW 

S063 6F MOV LeAé sPUT IN L 

3064 47 MOV Bef ISTART CHECKSUM 

w06S CLASSC CALL TINA ISTARTs HIGH 

“068 67 MOV HA sPUT IN H 

S069 48 MOV CyB ‘GET SUM 

~h6A CDASSC CALL TING sREAL CHECKSUM 

obé0 RP CMF Cc 9 SAME 

VNGE C2SBSN JNZ CSERR 5NO 

Y071 COB4S0 CALL POFF PREADER OFF 

vO74 7A MOV ArD sCHECK TASK 

9D7S FE4S CFI fee sEXECUTING? 
5077 CA7FSn JZ PCHLT §YES 

SO7A 3EA4S MVI Ay ’ES sEXEC ANDRESS 


SD7C C34S5SA JMPF ERR2 
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D7 F 


Srig8o0 
5083 
5084 
5287 
5088 
SDE? 
SD8A 
SD8B 
SO8E 
BN9i 
Sne4 
SN97 


SOSA 
SnoD 
SDE 
SAL 
SDA2 
SUAS 
SLAG 
SraAg 
_ SOAB 


SOAE 
Sed 


JDB4 
JDBS6 


WDB 
vICO 
SnCz3 
SDCS 
SC? 
snCC 


SDCF 


“ab “GD “Sh Sa “i> ga} SP NED “E> “a> 


THE NEXT LABEL CAN BE FLACED AFTER 
THE LABEL CALLS/GO NEAR THE BEGINNING 


E9 CHLT? PCHL 
MAKE BINARY TEST TAPE» EACH BYTE 
IS ONE LARGER THAN FREVIOUS BYTE 
WITH OVERFLOW, OO IS AFTER FF 
21F 401 TMAKE? LxI H» S00 sABORT CHECK 
7A TMAK2: MOV AvD sGET A BYTE 
CH9S3SC CALL TOUT sSEND TO TAFE 
14 INR if INCREMENT IT 
2B nCx H PDECR COUNT 
7C MOV ArH 
BS ORA L SEE IF ZERO 
C283Sn JINZ TMAK2 gNO 
CH2558 CALL INSTAT sTERMINATION? 
CA80SD JZ TMAKE ¢NO 
Ch1558 CALL INFUTT ¢°X FOR ABORT 
C3805 JMF TMAKE 5NO 
3 
§ READ BINARY TEST TAPE 
¢ EACH RYTE MUST BE ONE LARGER 
¢ THAN THE FREVIOUS ONE 
9 
CHB25C TTEST: CALL FIN GET A BYTE 
v7 MOV va sSAVE IT 
CUB25C TTEST2: CALL FIN gNEXT BYTE 
14 INR 0 gINCR FIRST 
BA CMF ft 9SAME? 
CAVESD JZ TTEST2 #YES 
SE43 MVI Av’C’ gNO 
CN2AS8 CALL OUTT sC FOR ERROR 
C39ASH JMF TTEST gSTART AGAIN 
3 
§ TAPE ERROR, FRINT B AND ADDRESS 
3 
CHB450 PERROR? CALL POFF 
C3435A JMP ERRB 
3 
’ TURN OFF TAFE READER 
9 
SE1S POFF: MVI AyCTRS ¢READER OFF 
C3935C JMF TOUT 
3 
’ FILENAME ERROR» PRINT ACTUAL 
§ FILENAME ON TAPE 
3 
2OS472793REMESS$ DE ’ Trys %90 
COB4SD FNERR: CALL POFF sREADER ON 
LiBOSD LXI DvsEMESS sERROR MESSAGE 
COSES? CALL SENDM gSEND IT 
11A697 LX Ds I BUFF $¢FILE NAME 
C33BS9 JMF SENDM sSEND IT TOO 
3 
END 


Symnols? 


SEO? 
SAED 
0008 
ooll 
5838 
SPOOF 
0008 
OQO7F 
SPSE 
gA4aS 
Oo18 
5AGG 
SBO0F 
SIFFS 
SB73 
OODR 
DBF 1 
280d 
825 
SBE9 
S7E9 
SAZO 
SAAO 
584A 
URSA 
GB44 
S9NF 
SB2A 
SOF 
ac7s 
0001 
STR4 
5C98 
S9RB?7 
aP90 
SBCC 
0055 
SACS 
SD4A 
g389C 
SCAS 
SCF E 
Ses 
SA00 
SEUSS 


SASS 


ADMP2 
ALOD2 
BACKUP 
CATA 
COLD 
CRLF 
CTRH 
DEL 
QUMF4 
ERR2 
ESC 
FILL2 
GCHAR 
HEX1 
HMATH 
INC 
INFPLG 
INPLI 
INSTAT 
JUST2 
LFLAG 
LOAL4 
MOVIN 
NFAGE 
OP ORT 
OUT4 
OQUTHL 
OUTT 
PCHLT 
PIS 
FIMSK 
FOFF 
POUTW 
RDWLA4 
READHL 
REPL 
SBYTE 
SEARS 
SKIF 
TABLE 
TINA 
TLDB2 
TMAR2 
TSTOF 
VERM2 
ZERQ 
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aB23 
FFF? 
SER4C 
001i 
3806 
SUSE 
0011 
BIAS 
B96? 
SA4aS 
S060 
SA6C 
B93P 
SPPl 
S7AS 
380C 
9919 
S800 
SBS0 
uBo2 
sAOn 
GAS? 
5878 
SCCA 
3800 
oong 
SIEC 
593i 
3C47 
gC 42 
SCB2 
0080 
0006 
S9Ci 
SA4E 
5803 
SAAN 
SAAA 
S7A0 
SBFA 
SlAc 
Sli2 
50g80 
Soa 
SBFS 


ALIMPS 
AFP OS 
BIT2 
CLATAD 
COUT 
CSERR 
CTR 
DUMF 
TUM S 
ERRB 
EXEC 
FILLS 
GETC4 
HHL DE 
IBUFC 
INLN 
INFLB 
INFLN 
IFORT 
JUSTS 
LOA 
LOADG 
MSIZE 
OFFST 
ORGIN 
OUTC 
QUTHX 
FASC2 
FLO 
FI 
FIN 
FOMSK 


FSTAT . 


ROHLS 
REGS 
RESTRT 
SEAR2 
SEARCH 
STACK 
TAFE 
TLO 
TLIA4 
TMAKE 
TTEST 
VERM3 


SB26 
SADS 
oB4A 
SABE 
oooh 
0010 
0013 
5948 
SOB? 
594 
57C6 
SA7S 
5925 
5A7C 
37ASG 
0001 
5901 
5S8iB 
SBAS 
SC88 


VALO 


DAIS 
JPC4 
w7ES 
JB2B8 
J8i2 
DIES 
3983 
SCSC 
0007 
vCBC 
J7AQ 
IB6S 
3989 
JEB4 
00C? 
JABS 
I93B 
9800 
57E8 
SOSE 
ICE7 
0018 
SUPE 
3831 


ALMP4 
ASCII 
BITS 
CHEKM 
CR 
CSTAT 
CTRS 
DUMPF2 
EMESS 
ERROR 
F RUF 
FILL4 
GETCH 
HLDEBC 
IBUFF 
INMSK 
INPLO 
INFUT2 
JERR 
LEADIR 
LOAD2 
MOVIN 
NIB 
OFSET 
OUT2 
OUTH 
OUTLL 
FASCS 
POL 
FDATA 
PINA 
FORTN 
PUTIO 
ROHL D2 
REPL 
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There are seven tape commands that can be given. The appropriate — 
command letter must immediately follow the letter T. The first thing that 
- should be done is to make a test tape. In fact, the test pattern should be 
recorded onto the beginning of each tape you own. Give the command 


>TM 


(tape make), and start recording. The computer will send a sequence of 
bytes, each being one larger than the previous one. When the maximum 
value of FF hex has been sent, the next byte will be a zero. Record the pat- 
tern for 15 to 30 seconds. Type a control-X to end the procedure. 

The integrity of the whole tape-recording system can now be tested. 
Rewind the test section of the tape and play it back. Type a command of 


>TT 


(tape test). The computer will read a byte from the tape, increment the 
value, then read another byte. If the two values don’t agree, then a letter C 
will be printed on the console. The process will then be repeated until you 
terminate it. | | 

If the two values do agree, then the computer will increment the first 
byte again, read another byte, and compare the two. This process will be 
repeated over and over. Each byte on the tape will be compared to see that 
it is exactly one larger than the previous byte. If you can go through a one- 
hour cassette recording without a single error, then you have a reliable 
system. 

You may have an adjustment on the A/D converter circuit that allows 
you to set the frequency of the phase-locked loop (PPL). The MITS audio 
cassette boards have this feature. Make a test tape at least 10 minutes long, 
then play it back. Adjust the PPL frequency until a stream of Cs appear on 
the console; then adjust the PPL frequency in the opposite direction. The Cs 
should not print. Continue adjusting the PPL in the opposite direction again 
until the Cs appear again. You have now bracketed the usable range of the 
PPL. Set the PPL adjustment halfway between these two extremes. 

There are some other tests you can make while the test tape is playing. 
Try moving both the audio cables and the AC line cords around to see if 
certain positions will cause an error. You can also try tapping the tape 
recorder, the computer case, the boards in the computer, and so on to see 
how delicate the system is. Pretty soon you will know if you have a reliable 
tape storage system. Remember to run the test tape at least once a week. 

- To save data from the computer’s memory, including the tape program 
itself, type 


=TDstart= “stor> <autostart> <“filename> 


After the D (for dump), give the start address, the stop address, the required 
autostart address, and an optional filename. A filename is important on 
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magnetic tape to ensure that you are loading the right program. The auto- 
start address can be the system monitor address. CP/M programs can be 
saved on tape using the original filename. Load the program into memory | 
with DDT, SID, or the program FETCH given in the next chapter. Branch to 
the tape program and give the command 


=TU100 SAF 100 TAPE.ASM 


The filename can include the decimal point and the file type. 
Each time a new tape is made, it should be verified with the command 


*TV<filename> 
A tape can be loaded into memory, at its normal position by typing 
STLifilename> 


At the conclusion of the load, the autostart address is printed on the con-_ 
sole then control returns to the monitor. If an incorrect filename is entered, 
the load operation is aborted and the actual filename on the tape is printed 
on the console. 

During the load operation, all printable characters are displayed on the 
console. If your console is a printer rather than a video console, you will 
have to remove this feature to prevent the computer from falling behind. In 
this case, take out the following three lines from subroutine POUTW. 


CPI ae 
RC 
QUT CLATA 


It is not necessary to verify the load step because of the checksum feature. 
If the load step was completed, then the tape was correctly read into 
memory. oe 

The E command can be used instead of the L command for loading 
data. In this case the computer will branch to the autostart address at the 
completion of the load. A BASIC interpreter could be saved with the auto- 
start address set to the BASIC start address. BASIC will then automatically 
start up at the completion of the E load command. The O command is used 
to load a tape at an offset from its regular address. 

While this binary format is designed for magnetic tape systems, it can 
be used for paper tape as well. If a tape is punched on a Teletype machine, 
there will be a strange sound. The reason is that binary, rather than ASCII 
characters, are being punched. The printout will also be meaningless. But 
when the resulting tape is read back, the operation is quiet, since the inputted 
characters are not echoed back on the Teletype. 


CHAPTER TEN 


Linking Programs to the 
CP/M Operating System 


The system monitor we developed in Chapters 6 and 7 allows us to com- 
municate with the computer through the console. But this program only 
provides the bare minimum of operations such as memory display, block 
move, hex addition and subtraction, and so on. Computers are capable of 
performing more complicated tasks such as decimal arithmetic, keeping 
business records, formatting text, and game playing. Computer languages, 
such as FORTRAN, COBOL, and Pascal, make these tasks easier. These 
languages will operate on programs (called source programs) that are written 
_ by the user. 

As an example, a BASIC interpreter, which may be as large as 24K 
bytes, needs a user’s source program for direction. An assembler needs a 
source file to generate the desired machine code. And, of course, a format- 
ting program needs a work file to produce a finished file. 

Because programs to perform these common tasks are so large, an 
efficient method of loading them into memory is needed. In addition, the 
output generated by these programs needs to be stored somewhere. Magnetic 
tape can be used for this purpose, but it tends to be slow. The floppy disk 
currently is a better medium. It is relatively inexpensive, and the recording 
medium, the diskette, can be removed. This means that backup copies can 
be easily generated. In addition, programs can be readily exchanged between 
users. 

We wrote our system monitor to transfer data between the console and 
the computer proper. Likewise, we need a disk-operating system (DOS) to 
effect an orderly transfer of information between the disk and the computer. 
Several different floppy disk systems are available for the 8080 and the Z-80. 
The disk-operating system that is provided with the disk drives may be 
relatively primitive, or it may be very elaborate. 

A very popular DOS available today for the 8080 and Z-80 is called 
CP/M. CP/M was initially developed for the 8080 S-100 buss and the 8-inch 
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soft-sectored floppy disk. It is now available for most of the other configu- 
rations, including the 5-inch floppies and the Winchester hard disk. Versions | 
are supplied for computers that don’t have an S-100 buss, such as the 
TRS-80. 

CP/M is a software system that must be interfaced to each different 
computer configuration through a set of software interface routines. Once 
the interfacing is accomplished, the computer programs that run with CP/M 
become system independent. 

The operating system integrates all of the common tasks. Before CP/M 
came along, each assembler and BASIC interpreter had to incorporate its. 
own text editor. The user could then write and correct the source program 
with the built-in editor. But with the CP/M operating system, the editing can 
be performed separately from program execution. An independent system 
editor is used to create an ASCII source file. Then a processor program such 
as BASIC, FORTRAN, Pascal, an assembler, or a text-output formatter can 
be directed to utilize the source file. The results can be stored in a separate 
ASCII file on the disk. 

It is possible to generate an assembly-language program with the system | 
editor, then assemble it as we did when we developed the system monitor in 
Chapters 6 and 7. In this case we had to tailor the console input and output 
routines to the host computer. In particular, we included in the program the 
address of the console status and data ports, and the read-ready and write- 
ready status bits. The sense of the status flags was selected with a JZ com- 
mand corresponding to an active-high flag. As a result of this approach, our 
system monitor is not portable. The monitor runs on your system, but it 
might not run on someone else’s unless the I/O details are changed. 

We approached a solution to this problem in Chapter 8, where we wrote 
some base-conversion routines. We did not have to write the I/O subroutines 
into each program because we utilized the ones in the monitor. 

When we wrote the monitor, we placed five jump vectors at the begin- 
ning. These provided an easy access to the commonly used routines. While 
this technique greatly simplifies things, it has the disadvantage that three 
bytes must be set aside for each different entry point. Also, the programmer 
must keep track of which entry is used for which task. . 

A better approach is to have only a single entry address for all opera- 
tions. When this special address is called by an external program, the values — 
in the CPU registers indicate the desired operation and provide the data. The 
CP/M operating system utilizes this approach. All of the systems operations 
are performed. by calling memory address 5. Up to 37 different operations 
can be performed in this way. Operations 1 through 11 allow interaction 
with the four logical peripherals named CONSOLE, LIST, PUNCH, and — 
READER. They are summarized in Table 10.1. Operation 12 allows a 
program to determine the current CP/M version. The remaining function 
numbers are used for disk operations such as reading, writing, and head 
positioning. 

The desired operation is selected by placing the proper function 
number into register C. Sixteen-bit data are transferred in the DE register. 
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Eight-bit data are transferred in Register E or the accumulator. For example, 
the console input status can be determined by placing the function number 
- of 11 (decimal) in the C register, and calling address 5. 


MVI Ceili 
CALL a] 


Table 10.1. CP/M 1/O operations. The function number is placed into register C. Single 
bytes are in register E. Double bytes are in the D, E register pair. 


Function 
number . Value 
(in C) Operation Value sent returned 
1 read CONSOLE char in A 
2 write CONSOLE char in E 
3 read READER char in A 
4 write PUNCH char in E 
5 write LIST char in E 
6 direct console I/O FF (input; char/stat in A 
char (output) 
7 get I/O byte IOBYTE in A 
8 set I/O byte IOBYTE in E 
9 print CONSOLE buffer buffer address in D, E 
10 read CONSOLE buffer buffer address in D, E characters in 
buffer: 
11 CONSOLE status - 0 = not ready 
FF = ready 


On return, the accumulator and register E contain the value of FF hex if the 
console is ready for input, or a zero if not. The byte in the console data 
register can then be read by calling address 5 with the value of 1 in register 
C. The byte that is read will be returned in the accumulator. 


CP/M MEMORY ORGANIZATION 


When CP/M is in operation, the main memory is divided into several regions. 
In order of decreasing memory, they are: 


. Basic Input/Output System (BIOS) 

. Basic Disk-Operating System (BDOS) 
. Console-Command Processor (CCP). 
. Transient-Program Area (TPA) 

. System parameter area 


of Gb e 


If the BIOS is especially tailored to a particular system, then it is called the 
customized BIOS or CBIOS. The BIOS and BDOS regions are collectively 
known as the Full Disk-Operating System (FDOS). The memory layout is 
shown in Figure 10.1. 
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yea end ae eraser ani a ! high memory 


Se ee eis seme ie ee eee 1 100 hex 
! sustem rarameters  ! 
Es ts ernie de regis ob eee a ee ! low memory 


Figure 10.1 A memory map for CP/M. 


BIOS contains the tailor-made routines for operation of all the periph- 
eral devices such as the console, printer, disk drives, phone modem, and tape 
drives. BDOS has the hardware-independent routines for the disk operating 
system. The CCP handles the console commands. It contains the built-in 
routines such as DIR, LIST, and ERA. Separate programs such as PIP, DDT, 
and user-written programs execute in the TPA. 

The lowest memory area contains several different items. The first is a 
warm-boot entry to BIOS. The first few entries are: 


Address Action Purpose 

0 JMP BIOS+3 warm start entry 

3 IOBYTE peripheral assignment 

4 disk current drive number 

5 JMP BDOS+6 peripheral control 

dC hex FCB command-line argument 


CHANGING THE PERIPHERAL ASSIGNMENT 
CP/M can interact with four logical peripheral devices. These are termed: 


CON: console 

LST: _ list (printer) 
PUN: punch 

RDR: (tape) reader 


Each of these four logical devices can be assigned to four different physical 
devices. The 16 different possible combinations can all be encoded into the 
IOBYTE located at memory address 3. The colon is part of the name; it is 
used when referring to peripheral devices. Disk filenames, on the other hand, 
are written without the colon. 

The actual mapping of the logical devices into the desired physical 
devices must be accomplished in BIOS. Since there are so many different 
possibilities, it is not likely that the system supplied by your dealer will have 
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the IOBYTE features fully implemented. The CP/M logical console is prob- 
ably mapped into your video terminal and the logical list device will be 
mapped into your printer. But the punch and reader might be mapped into 
your video terminal. 

Even if you have only two peripherals, it may be useful to set up the 
IOBYTE feature. For example, suppose that you have both a video terminal 
and a printer such as a Decwriter or Teletype that has its own keyboard. 
Then either peripheral can be used for the console input and either can be 
used for the console output. The four physical console arrangements could 
correspond to: 


IOBYTE Input Output 
0 video video (default) 
1 video printer 
2 printer _ printer 
3 printer video 


Your customized BIOS (CBIOS) will set the default combination on a 
cold start. But any user program can change the IOBYTE to a new configu- 
ration. Also, the CP/M programs STAT and DDT can be used to alter the 
IOBYTE. The instructions in CBIOS will sample the IOBYTE and act 
accordingly. 

Suppose that the IOBYTE is set to zero, and you load a BASIC inter- 
preter. You develop a program that sends information to the console. The 
program will include statements like 


4 + * 


FRINT Iv X(T)» YCT) 


+ ® + 


The resulting output appears on the console video screen. After the program 
is debugged, you would like a hard-copy output of the program results. This 
is easily done if you have incorporated the IOBYTE feature. You can change 
the IOBYTE with the POKE command in the BASIC interpreter. 


FOKE 3, 1 
RUN 


The POKE command will change the IOBYTE at address 3 from a zero to 
a 1. Console output will now appear at the printer when the BASIC program 
is run. Of course, console input has not changed; it still comes from the 
video terminal. At the conclusion of the run, the IOBYTE can be restored 
with another POKE command. 


POKE 3% 0 


As another example, suppose that you have a Teletype for your list 
device and it has a paper tape reader and punch. You can easily make BASIC 
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tapes and reload them using the IOBYTE features. POKE the IOBYTE toa 
value of 1 for punching a source tape. This will map the Teletype output 
into the logical console output. Give the BASIC commands 


NULL 3 
LIST 


to make a tape of the source program. 
Later, you can reload the tape into BASIC by setting the LOBYTE toa 
value of 3. . 


FOKE 3,9 3 


Just put the tape into the reader and turn it on. With this configuration, the 
Teletype keyboard and tape reader perform the console input. But the video 
screen is used for console output. After the tape has been read, give the 
command 


FOKE 3? 0 


from the Teletype keyboard to return to the console keyboard. 


INCORPORATING THE IOBYTE INTO YOUR CBIOS 


You will have to reassemble your CBIOS if you want:to incorporate the 
IOBYTE feature. A sample CBIOS that uses the IOBYTE is given in Listing 
5.1. This version additionally features such things as an interrupt-driven key- 
board and connection to a telephone modem. 

At the beginning of BIOS there are seven jump vectors that are used by 
other parts of CP/M. 


JMP INIT initialization 
JMF CONST console status 
JMP CONIN console inFrut 
JMF CONOUT ¢console outrut 
JMF LOUT glist outrut 
JMP FUNCH jrunoch 

JMP REAR jreader 


Because of these fixed entry points, BIOS can be altered without having to 
alter any other part of CP/M. There are four regions of BIOS that need to 
be changed if the IOBYTE feature is incorporated into console routines. 
These are the routines for initialization, console status, console input, and 
console output. We have to set the IOBYTE to the default value in the 
initialization section of BIOS. Then, at the beginning of the three console 
routines, we have to read the IOBYTE at address 3, and branch to the 
appropriate subroutine. 
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In accordance with the step-by-step approach to programming we used 
in Chapter 6, we will not make all the changes at one time. The first altera- 
tion will be to the initialization and output routines. 


Incorporating the IOBYTE into Output Routines 


First locate the initialization region of BIOS. This area is referenced by the 
first jump instruction at the beginning of BIOS. Add the following instruc- 
tions somewhere in the initialization routine. 


MVI Ar9 sdet a zero 
STA 3 sSET IOBYTE 


The safest places to put them are at the very beginning of the initialization 
section or at the end, just before the RET instruction. We could, of course, 
use an XRA A instruction rather than the MVI A,0 instruction shown above. 
This would reduce the size of BIOS by one byte. But if we later wanted 
BIOS to initialize the IOBYTE to 3 we would have to reassemble BIOS. 
With the MVI instruction, we can easily change the argument of zero to a 3 
by using the system debugger. 

Refer to the label START at the beginning of Listing 4.1 where there is 
a series of jump instructions. 


START; 
JME INIT sINITIALIZATION 
JMP CONST gCONSOLE STATUS 
JMP CONIN sCONSOLE INPUT 
JMF CONOUT sCONSOLE OUTPUT 


Locate the address of the console-output routine. This can be found from 
the fourth jump instruction, JMP CONOUT in this case. We will now alter 
the console-output routine so that it will read the IOBYTE at memory 
address 3 and act accordingly. The upper six bits, which refer to the list, 
punch, and reader, are reset by performing a masking AND with the value 
of 3. 


XXXX XXO1l or XXXX XX10 IOBYTE 
ii 1i ANT with 3 


Se anatiemdanatemtbanntcientaantcenn! ene eee othe Hate neem name eats oem ee 


0000 0001 or 0000 0010 IORYTE 


The two low-order bits then determine whether output is sent to the console 
or to the printer. If the resulting value is a 1 or a 2, then a branch is made to 
the printer-output routine. Otherwise, output goes to the video console. 
Printer output corresponds to the following IOBYTE bit patterns. 


LINKING PROGRAMS TO THE CP/M OPERATING SYSTEM 221 


0000 0001) or 0000 0010 IOBYTE 
11 11 AND with 3 


Aeee cunt Meee wine nate vat tee ane meee ook mobs ete emee ents een muah entt ores 


0000 0001 = i 0000 0010 = 2 

The other two possible IOBYTE patterns correspond to console output. 
0000 0000 = 0 or 0000 0011 = 3 

Notice that parity is odd for printer output but parity is even for console 


output. Thus the BIOS code at this point is programmed to jump to the 
list-output routine if parity is odd. 


9 
§ LOGICAL CONSOLE OUTPUT 


9 

CONOUT: LDA IOBYTE GET ASSIGNMENT 
ANI 3 ‘ ¢MASK FOR CONSOLE 
JFO LOUT gLIST OUTPUT 


> VIDEO-OUTFUT ROUTINE 


3 

9 

9 : 

VIDEO?. « »« (existing routine) 


% @ % 
a 


9 


§ LIST-OUTPUT ROUTINE 


g 
LOUT? » © « (@xistind routine) 


° ¢ e 


Assemble the new BIOS and try it out. We can use the system debugger 
DDT or SID to load the new CBIOS over the old one. The command is | 


A>DOT CBIOS.HEX 


One word of caution: Since the debugger uses the routines in CBIOS, there 
may be a problem. A safer way to put the new CBIOS into place is to first 
load it somewhere else. 

Use the hex arithmetic command of DDT to calculate the offset. Sup- 
pose that BIOS is assembled for the address DBOO hex and you want to load 
it temporarily at 100 hex. Then the command 


H1i00 DBOO 


will give both the sum and difference of the two addresses. The difference is 
what we need. Load CBIOS with the indicated offset 


ICBIOS.HEX 
Rioffset) 
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DDT will indicate the location of the end of BIOS. The move command can 
now be used to put BIOS into its proper place. 


M100 2FF DBOO 


The second address will be the present end of BIOS. The new BIOS is now 
in place. If the debugger no longer works, there may be an error in BIOS or 
there may have been an error in the move command. 

If everything appears to be all right, try out the IOBYTE feature. Use 
the S (set) command of the debugger to change the IOBYTE at address 3. 
Change the value of the IOBYTE from a zero to a 1. 


“$3 
-9003 00 1 (tyre a 1) 
0004 00 . (tyre a decimal roint) 


The (logical) console output should now appear at the printer instead of the 
console. Notice that this is different from typing a control-P when the 
IOBYTE has a value of zero. In fact, if a control-P is typed at this time, each 
typed character should be printed twice. Return the logical console output 
to the console by changing the IOBYTE back to zero using DDT. 


$3 
0003 O1 O (tyre a O) 
0004 00 . (tyre 3 decimal roint) 


Output should return to the console. 

If everything appears to be all right, you are still not finished. You have 
a working copy of BIOS in memory; now you must get a copy onto the sys- 
tem tracks of the disk. Continue with this section if you want to write a 
permanent copy of the new BIOS onto the disk. Otherwise, go on to the 
second part of the alteration where you will add the IOBYTE feature to the 
console input routines. Then come back to this section to save the com- 
pleted BIOS. If you have a Lifeboat version of CP/M, you can easily copy 
the new version of BIOS to the disk. Just give the command 


A>SAVEUSER 


and the new BIOS will be copied to the system disk. 

Another method of getting the new CBIOS on the disk system tracks 
is to use SYSGEN. The current version of CPM is loaded into memory with 
the DDT command 


A>DOT CRMXX.COM 
where XX refers to the memory size. Then move the working version of 


BIOS down to the proper SYSGEN position using the DDT move command. 
Alternately, the HEX file of CBIOS could be copied from disk into memory. 
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The SYSGEN location for BIOS should be given in your CP/M documenta- 
tion. Perform a warm start with a control-C, and then give the command 


A=SYSGEN 


Answer the first question about where to get the system by typing just a 
carriage return. The second question asks where to put the system. Give the 
appropriate drive name, A, B, etc. The new BIOS will now be copied to disk. 


Incorporating the IOBYTE into Input Routines. 


We are now ready to implement the second part of the console IOBYTE 
feature. This will allow the logical console input to be obtained from either 
of two keyboards. One of these keyboards will be the video terminal; the 
other will be the printer. If you don’t have a second keyboard, go on to the 
next section. 

Locate the console status and the console input routines. These are 
found from the second and third entries of the jump table of BIOS. Your 
present console-input routine may be coded in one of two ways. One 
method is straight-forward. The input routine has a status check independent 
of the regular BIOS status routine. 


CONSOLE INFUT ROUTINE 


a 
$ 
a 
3 
a 
3 
C 


ONIN: IN CSTAT sGET STATUS 
ANI CIMNSK gMASK FOR INPUT 
JZ CONIN §LOOF UNTIL READY 


The other method uses the BIOS status routine. 


4 
? 


§ CONSOLE INPUT ROUTINE 


7 
CONINS CALL CONST 9GET STATUS 
JZ CONIN #LOOF UNTIL REALY 


+ > ° 


Although either method can be altered to include the IOBYTE feature, 
the former method will be demonstrated here. We will need two separate 
input routines. One is for the video screen and the other is for the printer or 
other keyboard. Our new console input routine might look like this. 


LOGICAL CONSOLE INPUT 


“ab “Gb “tp 


CONIN? LDA IOBYTE GET ASSIGNMENT 
ANI 2 gMASK FOR LIST 
JNZ LISTIN $LIST INPUT 


aeneeemmmmnesnenenaeneeenereainemeeeeimmmemeenneaieiaeeemaenmemmnmeememn nneeaanenr gente = meine ormeetnermmmesanmnenmnenrinemnne artim anton aana naan eanaaraanaanarenr a eeranes aaeaeer ea a ne teen enemy pee eel 
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VIDEO INPUT 


Cw ~<a ao 


IDIN: IN 


f" a> ae sap 


ISTIN: IN 
ANI 
JZ 
IN 
ANI 
RET 


The third jump statement at the beginning of BIOS should branch to 
the label CONIN. The IOBYTE at memory address 3 is read. All bits but 
bit 1 (the second bit) are zeroed with the ANI 2 command. List input corre- 
sponds to an JOBYTE of 2 or 3. The logical AND with 2 and either value 


CSTAT 
CIMSK 
VIDIN 
CDATA 
7FH 


INPUT FROM PRINTER 


LSTAT 
LIMSK 
LISTIN 
CDATA 
7FH 


will produce the result of 2. 


0000 0010) or 
10 


een ene seme eae sree seme sone cette 


0000 0010 


The JNZ instruction will then cause a branch to the list-input routine. 
Otherwise, program flow will continue on to the console-input routine. 
A similar construction can be used for the console status routine. 


5 
5 
5 
CONST? LDA 
ANI 


JINZ 


<— ap sap sap 


STAT? IN 


INPUT FROM 


ISTST’ IN 


0000 OO11 
10 AND with 2 


eve) mete name mete pete wee nome yore Hhee 
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9GET STATUS 

sMASK FOR INPUT 
gLOOP UNTIL READY 
sGET TATA 

gMASK FARITY 


GET STATUS 

sMASK FOR INPUT 
3LOOF UNTIL READY 
#GET DATA 

sMASK PARITY 


IOBYTE 


0000 0010 = 2 


LOGICAL CONSOLE-INPUT 


IOBYTE 


2 


LISTST 


INPUT FROM VIDEO 


CSTAT 
CIMSK 


Av OF FH 


LIsT 


LSTAT 
LIMSK 


Av OFFH 


STATUS 


sGET ASSIGNMENT 
gMASK FOR LIST 
gLIST 


gCHECK STATUS 
gMASK FOR INFUT 
gNO REALY 

sSET FOR REALY 


SCHECK STATUS 
SMASK FOR INPUT 
sNOT READY 

sSET FOR REALY 
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Assemble the new version of BIOS and try it out as we did in the previous 
section. Load the debugger, then use it to change the IOBYTE at address 3. 
First, change the IOBYTE to a value of 3. This will assign the logical console 
input to the printer (or other alternate keyboard) and logical console output 
to the video screen. As soon as you make the change, all further input must 
come from the printer. Use the debugger to change the IOBYTE to a value 
of 2. Now logical console input must come from the printer, and logical 
console output will appear at the printer. Finally, change the IOBYTE back 
to the value of zero. Console input and output should both go through the 
video terminal. 


USING STAT TO CHANGE THE IOBYTE 


The CP/M program called STAT can be used to symbolically change the 
IOBYTE. STAT can also be used to determine the current value of the 
IOBYTE. Each of the four logical devices CON: (console), RDR: (reader), 
PUN: (punch), and LST: (list) can be assigned to four different physical 
devices. 


Logical device — Physical device 

i 2 3 4 
CON: console TTY: CRT: BAT: UC1: 
RDR: reader TEY<. PUP: URI: UR2: 
PUN: punch TTX: ~PYP: UPI:  UP2: 
LST: list TTY: CRT: LPT: ULI: 


The first column represents the four logical peripherals. The remaining 
entries on each line represent the four physical devices. You can easily change 
these names in STAT to something more descriptive. Load STAT into mem- | 
ory with the debugger. 


DOT STAT.COM 


Then dump the first few lines. 


Di00O 16F 


You will see the names of the logical peripherals and the physical peripherals. 
encoded in ASCII. You can now change any of the names to something else. 
You might want to choose the names 


CRT: 
LST: 
LPT: 
LCR: 


226 8080/Z-80 ASSEMBLY LANGUAGE 


for the four console devices. These four names correspond to the IOBYTE 
values of 0 through 3. After you change the names with the debugger, return 
to CP/M and save the altered STAT. If the IOBYTE is currently set to zero 
and you type the command 


A>STAT CONS=LST3 


STAT will change the IOBYTE to a value of 1 and console output will appear 
at the printer. The IOBYTE can be set back to zero with the command 


A>STAT CON?=CRT? 


If you have other peripherals, such as a phone modem, these can also 
be incorporated into IOBYTE. The logical punch can then be sent to the 
modem, the printer, or the console. A disk file can be sent over the phone 
modem with the command 


A>STAT FUN? =BiCPMIO.ASM 


where CPMIO.ASM is a disk file on drive B. As you can see, there is room for 
a lot of imagination. 


A ROUTINE TO GO ANYWHERE IN MEMORY 


The assembly language program shown in Listing 10.1 can be used to branch 
to any location in memory. Executable programs in CP/M are usually designed 
to be run starting at address 100 hex, since this is where programs are loaded 
-by CP/M. There are times, however, when it is desirable to assemble a pro- 
gram for operation at some other location. The system monitor developed in 
Chapter 6 is one such program. If this monitor is to be located in ROM, 
then it must be placed above the CP/M operating system. A location of F000 
hex would be ideal. But there is no easy way to get to the monitor from the 
CP/M system. If the GO routine is located on disk drive A, then we have 
only to give the CP/M command 


A>GO F000 


and a branch will occur to the address F000 hex. 
| ~ The GO program demonstrates several of the I/O features available with 
CP/M. The branch address given as an argument on the above command line 
is read from a region of memory called the file-control block (FCB). The 
address of the FCB is 5C hex but the ASCII-encoded address starts at 5D 
hex. The input address, FOOO in this example, is a valid hexadecimal number; 
it is to be converted from ASCII into a 16-bit binary number. The result is 
placed into the CPU program counter so that the computer will branch to 
the desired address. The address format is free-form, and leading zeros are 
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Listing 10.1 A Frosgram to go anywhere in memory, 


0100 


0005 
0O0SC 
0009 
000A 
ooon 
000A 


0100 2 


0103 
0104 
0106 
0109 
010C 
O10F 


0110 
0113 
0116 
0118 
0119 
o1ic 


O11F 2 
0120 ; 


0121 
0122 
0123 
0124 
0125 


0128 
012A 


0128 


O120 
O12E 
O12F 
0131 
0132 
0133 
0135 
0137 


HOH HO OH WOH 


229RO01 
CH1001 
E? 


210000 
ChH4301 
FE2O 


§ (date goes here) 
3 


TITLE 
3 
¢ USAGE: TYPE 
3 
ORG 100H 
3 
BBOS EQU 
FCB EQU 
F BUF EQU 
ROBUF EQU 
CR EQU 
LF EQU 
9 
START? 
LXI 
MOV 
CFI 
JZ 
AGAIN: SHLD 
CALL 
PCHL 


> “GP MID Nae 


READHL? LXI 


RDHL2 


a Gr “> “a> 


IB: SUI 


ap 


‘GO (Jjumpe anywhere) ’ 


GO F800 TO JUMF TO F800 HEX 


a #DOS ENTRY FOINT 

JCH sFILE CONTROL BLGCK 
9 sPRINT BUFFER 

10 sREAD CONSOLE BUFFER 
ODH sCARRIAGE RETURN 

OAH gLINE FEED 

HyFCBt+1 §GET ARGUMENT IF ANY 
AgyM sFIRST BYTE 

Pee 9 BLANK? 

ERROR sNO ARGUMENT 

RBUFP §SAVE POINTER 

READHL sGET ADDRESS 


960 TO ADDRESS 


CONVERT ASCII-HEX CHARACTERS 
TO 16-BIT BINARY NUMBER IN Hoel 


H»d §START WITH 0 
GETCH *GET A BYTE 
f- sEND? 

gYES 
NIE 3T0 BINARY 
RDHLA sNOT HEX 
H eTIMES 2 
H sTIMES 4 
H sTIMES 8 
H ¢TIMES 14 
L *COMBINE NEW 
LA sFUT BACK 
RDHL 2 3NEXT 


CONVERT ASCII TO BINARY 


“O° SASCII BIAS 
; <2 0 


SE OR OCHL 


sf 
“Ti 


10 


3A NUMBER 0-9 
a ne ee | 
10 
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BLANK AT END OF LINE IS OK 
ELSE AN ERROR 


Do ae ae 


0138 FEFO DHL43 CPI (fmt Qe 
013A CB RZ 


IMFROFER ARGUMENT» TRY AGAIN 


fT] -~a> ~<a «> 


O13B 117501 RROR? LXI DeMESG *FOINT TO MESSAGE 
 O13E C5901 CALL PRINT sSEND IT 

0141 119001 LXI DesRBUFM FINPUT BUFFER 
0144 COSEO1 CALL READE GET A LINE 
0147 1600 MVI Dvd 
0149 SAPEOL LOA RBUFL yBUFFER LENGTH 
O14C OF MOV EvA 
0140 219F01 LXI He RBUF 
0150 19 nan nh gFAST BUFFER 

' 0151 3620 MVI Me’ ¢ 7PUT IN BLANK 
0153 219FO1 LXI H» RBUF 
0156 C30901 JMF AGAIN  sTRY AGAIN 


; : 
§ FRINT CHARACTERS UNTIL $ IS FOUND 
3 


0159 OEO09? PRINT? W¥VI CePBUF §SET FOR PRINT 
O1SB C30500 JMF BDOS 


5 
§ INFUT A LINE FROM CONSOLE 
3 


O1LSE OEOA READBS MMVI CyRDBUF *READ INPUT BUFFER 
0140 C30500 JMP BNOS 


GET A CHARACTER FROM THE INPUT BUFFER 


0163 ES5 ETCH? FUSH H 
0164 2APKRO1 LHLOD REUFF sGET POINTER 
0167 7E MOY AyM sGET NEXT CHAR 
0168 23 r INX H §INCREMENT FOINTER 
O1469 229801 SHLD RBUFF sSAVE FOINTER 
016C FE41 CFI ‘Z° +7 SUPPER CASE? 
OL16E DA7301 JC GETC2 §NO 
0171 ES6SF ANI SFH §sMAKE UPFER CASE 
0173 El GETC22 FOF H 
0174 C9 RET 

MESG3 
01735 4&74F206572 DE ‘GO error. Inmreut / 
0185 74684652041 DR ‘the address asain.’ 
0197 ODOAZAZ4 re CReo LF» “xs? 

$ : 
O19B 9FO1 RBUFF? DW RBUF sRUFFER POINTER 
O19 OA RBUFM? [IB 10 MAX SIZE 
O19E REUFL: hS i SACTUAL SIZE. 
O19F RBUF DS 1 sINFUT BUFFER 

ta 
Q1A0 END 
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unnecessary. If more than four characters are entered, only the last four are 
used. Thus, all of the following are valid. 


0 F000 
900 P¥800 
6000 


If no argument is given to the GO command, or if an invalid hexadeci- 
mal address is entered, then an error message is printed. This step uses the 
console string-output feature, selected with the function code of 9 in register 
C. The DE register pair is loaded with a pointer to the. string location in 
memory. A dollar sign ($) is used to indicate the end of the string. In sub- 
routine SENDM of Chapter 6, a binary zero is used for this purpose since it 
requires less code. . 

The user can retype the desired address after the error message has been 
printed. This time, however, the program reads the input string data in a 
different way. The console string-input operation is selected by loading the 
C register with the function number of 10. If the new string is a valid hex 
number, it is converted to a 16-bit binary number. The computer then jumps 
to this address. If the input is still invalid, the error routine is repeated again. 

During the input operation, the usual CP/M commands are available for 
error correction. For example, the most recently typed character can be 
deleted by pressing the DEL key. A control-R will reprint the current line in 
its corrected form. A control-U cancels the entire line so that it can be 
retyped. If Version 2 of CP/M is being used, then the backspace character, 
control-H, can also be used for correcting errors. Finally, a control-C can be 
entered to abort the entire program. This returns control to the CP/M | 
operating system. 

Enter the GO program in Listing 10.1. Assemble it and try it out. GO 
is a universal program; it will work on any system. If you have a monitor 
located in memory, use GO to branch to it; if not, you can still try out the 
GO program. Type just the command of GO without an argument. An error 
message should be printed. Type some characters, then delete some of them 
with the DEL key. The deleted characters will be printed a second time. 
Reprint the line with a control-R to see the correct version. Finally return 
to CP/M by giving the address of zero. 


GO 0 


A control-C can also be used to return to CP/M. 


A LIST ROUTINE WITH DATE AND TIME 


In Chapter 7 we developed a monitor routine for sending data to a separate 
list device. When this routine is activated with a control-P command, the 
output appears at both the console and the printer. CP/M has a similar 
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arrangement. A control-P command will activate the list device, too. Output 
is then sent to both the console and the printer. 

But the console and list routines are entirely separate in CP/M. Output 
- ean therefore be sent specifically to the list device and it will not appear on 
the console. In CP/M I/O operations, a function number of 2 corresponds to 
console output, and a function number of 5 corresponds to list output. If 
memory address 5 is called with a value of 2 in the C register, then the byte 
in the E register will be displayed on the system console. On the other hand, 
if a function number of 5 is placed in the C register, then the byte in register 
E will appear on the list device. The byte in the E register can be sent to the 
punch by loading a function number of 4 into the C register. 

This complexity may seem unnecessary, since the list device can be 
turned on by typing a control-P. If the command 


ASTYPE <«<filename> 


were given, then the file would be sent to both the console and the printer. 
The disadvantage of this method is that the TYPE command line will appear 
on the printer output. Also, when the listing is finished, the new prompt of 
A> will be printed on the listing. 

The CP/M utility program PIP can be used to send a disk file specifically 
to the list device. The command is 


ASPIF LSTi=ifilename>CT8] 


The argument T8, embedded in brackets, will expand the ASCII tab char- 
acter to 8-column fields. PIP, however, does not automatically eject a new 
page when a form feed is encountered. 

The LIST program in Listing 10.2 can be used to send an ASCII disk 
file to the printer, too. It will automatically expand the ASCII tab character. 
Furthermore, when a form-feed character is encountered, LIST will add the 
correct number of lines to the end of the page. At the end of the disk file, 
additional line feeds are issued to finish the page. This will ensure that the 
printer will start the next task on a new page. If the file contains an odd 
‘number of pages, then an extra blank page is added to the end. Without this 
feature you will have to refold about half of the output. 

- If your computer keeps track of the date and time, LIST can print 
current values at the top of the first page. The name of the disk file is also 
printed on this line. 

LIST is a very small program, requiring only 1K bytes of memory. It 
_ was derived from the program called DUMP in the CP/M Interface Guide. 
LIST bears only a passing resemblance to DUMP, however. DUMP is designed 
to convert binary files to ASCII-hex characters and display them on the 
console. LIST, on the other hand, prints ASCII files directly with no conver- 
sion. Since the CP/M BDOS is used for all I/O and disk operations, LIST will 
operate with all standard CP/M systems. 
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Listing 10.2. List an ASCII disk file. 


SEND ASCII DISK FILE TO LIST 

PUT DATE AND TIME AT TOF OF PAGE 
ENTIRE FILE LOADS INTO MEMORY FIRST 

FORMFEEDS ADDED WITH F ARGUMENT 

EXTRA PAGE ADDED TO MAKE TOTAL EVEN 
UNLESS A F OFTION IS GIVEN 


USAGE 3 
LIST <filename> 
LIST «<filename> F (add form feeds) 
LIST <filename> F (mo extra rade) 
LIST <filename> m (skie m lines) 


(date does here) 


“> “so “Gb “UD “GD “Eb ‘Gs “Gp “Ud “a> “GD Win sap wap woe 


TITLE ‘List am ASCII disk file.’ 


0100 ORG 100H 
0005 = BOS EQu 5 sDOS ENTRY FOINT 
0001 = CONS EQU 1 sREAD CONSOLE 
0005 = TYPEF EQu 5 $LIST OQUTFUT 
0009 = FBUF EQU 9 sPRINT CONSOLE BUFFER 
OOOR = BRKF EQU 1i SKILL? (TRUE IF CHAR) 
QOOF = OPENF EQU 15 sFILE OPEN 
0014 = READF EQu 20 sREAD FUNCTION 
OOoOn = CR EQU ODH SCARRIAGE RETURN 
000A = LF EQu OAH sLINE FEED 
001A = EQF EQU 1AH 3END OF FILE 
0009 = TAB EQu 9 $I 
QO0C = FORMFO EQU OCH $FORM FEED 
003A = LINES EQu 598 3LINES/PAGE 
0042 = LMAX EQu 6 $MAX LINES 
p 
OO5C = FCB EQU SCH sFILE CONTROL BLOCK 
0080 = BUFF EQu 80H sDISK BUFFER ADR 
? 
¢ FILE-CONTROL BLOCK DEFINITIONS 
yp 
OO5n = - FOBFN Eau FCB+1 $F ILE NAME 
0068 = FCBRL EQuU FCB+12 #CURRENT REEL ¢ 
0070 = FCRCR EQU |. FCBt32 #NEXT REC #(0-127) 
# 
§ TIME AND DATE FROM A COMPU/TIME BOARD 
¥ 
00C4 = ALATA EQu OC4H 3FORT A DATA 
OOoCcS = ACONT EQu ADATAt1 #PORT A CONTROL 
00C7 = BCONT EQu ADATAt3 #PORT B CONTROL 
00C6 = RLUIATA EQu ADATAt2 #PORT B BATA 


SAVE OLD STACK AND SET UP A NEW ONE 


0100 210000 TART? LXI Hr0 

0103 39 DAL SP 

0104 22E004 SHLD OLDSP §SAVE STACK 
0107 310005 LXI SP »STACK 

O10A 111E04 LXI De RULES 

010D COS3EO2 CALL FRINT sHOW TO ABORT 
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0110 
0113 
0116 
0117 
0119 
011C 
O11E 
0121 
0123 
0126 


0128 
0129 
012A 
0128 
012C 
0120 
O12E 
O12F 
0131 
0132 
0133 


0136 
0139 


013C 
O13F 
0140 


0143 
0146 
0148 
O14B 


O14E 
o151 
0152 
0153 
0156 
0157 
015A 
O1SR 
0150 
0160 
0161 


0164 
0165 
0168 
O16B 


FE20 
CA4001 
FE4S 
CASCOiI 
FESO 
CAZ401 
14630 


C31601 


320904 
C33FO1 


S320H804 
AF 
22DA04 


CDRZO02 
SE80 

32DE04 
320304 


2ATA04 


7C 


BS 
CA6401 
ES 
Ch4302 
Et 
FEOD 
C25601 
2k 
C35101 
AF 
320504 . 
CD4302 


ES 


Gb “ES “a> 


SKIP2¢ 


“Is “SP “OD 


- 


5 
NOPAGE¢ 


; 
FORM: 
ZERO>s 
SKIFS 


“a: 


REAL 


a 
? 
a 
¥ 


a 
? 


MAING: 


MAIN? 3 


3 
MAINS; 


MAIN? 3 


LXI 
LXI 
L.EIAX 
CFI 


CONVERT ASCII 


MOV 
MOV 
DAD 
LAD 
DAD 
DAD 
MOV 
NVI 
HAL 
INX 
JMF 


STA 
JMP 


STA 
XRA 
SHLI 


HO 

By SDH 
BR 
SKIFS 
ad 
FORM 
ipo 
NOP AGE 
“Q?’ 


DECIMAL 


DeH 
Eek 
H 

H 

hh 

H 
EA 
BsO 
0 

B 
SKIF2 . 


PFLAG 
ZERO 


FFLAG 
A 
SKIFB 


HOW MANY LINES TO SKIF BEFORE STARTING? 


33RD ARGUMENT 

#GET CHARACTER 
SBLANK AT END 

; DONE 

$NEED FORM FEELS? 
*YES 

SEXTRA PAGE? 

$NO 

$REMOVE ASCII BIAS 


TO BINARY IN Hel 


sDUPLICATE 
PHol IN DoE 
sTIMES 2 
*TIMES 4 
gTIMES 5 
§$TIMES 10 


sADD NEW BYTE 
gINCR POINTER 
§NEXT 


§5NOQ EXTRA PAGE 
gSET FOR FORM FEEDS 


gRESET COUNT 
gSAVE BINARY CNT 


AS MUCH AS FOSSIBLE INTO MEMORY 


CALL 
MVI 
STA 
STA 


LHLD 
MOV 
ORA 
JZ 
PUSH 
CALL 
FOF 
CFI 
JINZ 
nex 
JMP 


XRA 
STA 
CALL 
FUSH 


SETUF 
Ay 80H 
IBF 

TIME? 


SKIPB 
AvH 

L 
MAINS 
H 

GNB 

H 

CR 


SET UP INPUT FILE 


sSET POINTER TO 80H 
sSET 1ST FASS 


HOW MANY LINES? 


SHelL = OF 
NO SKIF 


gNEXT BYTE 


sLOOK FOR CR 
sDECR COUNT 


sRESET FLAG 
gGET A BYTE 
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O16C 2ANCO4 LHL BUF FF sMEMORY FOINTER 
O146F 77 MOV MoA gFUT BYTE IN 
0170 23 INX H 
O171 220004 SHLD BUFFP  §SAVE FOINTER 
O174 47 NOV BvA 
0175 SEFF MVI Av OFFH 
0177 BD CMF L. §L=OP? 

~ 0178 C28R01 JINZ MAINA ¢NO 

9 CHECK FOS 

0178 3A0700 LOA 7 sF DOS 
O17E D60A SUI 10 sCCP ~1 
0180 RC CMP H sTOO BIG? 
0181 D28R01 JNC MAINA §NO 
0184 SELA MVI A»rEQF 
0186 77 - MOV MA gPUT IN MEMORY 
0187 320504 STA FULL sSET FOR FULL 
O18A 47 NOV BA 
O1L8B 78 MAINA? MOV Av §GET BYTE 
o1sc E1 POF H 
0180 FELLA CFI EOF 
O18F C26801 JNZ MAING 9NO 


CHECK FOR EOF AT ENT 


> “Eb sae 


0192 2ANDC04 LHL Ti BUFFP ?GET FOINTER 
0195 2B nex H 

0196 SEA MVI Av EOF 

0198 BE CMF M sEQF? 

0199 CAAIOI JZ MAING sYES 

O19C 23 INX H 

O190 77 MOV MA gFUT IN EOF 
OL9E 220004 SHLIN BUFFF 


O1A1l CU7CO2 AINS: CALL RESET sFOINTER 


FUT TIME AT START OF LISTING 
REMOVE FORMFEED IF FIRST 


> <a> sop sce EY sae 


O1A4 CUSHOS CALL CLOCK 9GET TIME 
OLA7 SADB04 LIA FFLAG >FORMFEERS? 
OLAA B7 ORA A 
O1AB C4F601 CNZ TWOLN ¥YES 
OLAE COSFO2 CALL GETB sGET BYTE 
O1B1 FEOC CPI FORMFID sFORMFEED 
O1B3 C2BCO1 JNZ GLOF2 9NO 
O1B6 COF601 CALL TWOLN §SEND 2 LF 

# 
O1B9 CDSFO2 GLOOF: CALL GETB §GET NEXT BYTE 
O1BC 47 GLOF2: MOV ByA 9SAVE BYTE 
O1BD COFNO2 CALL TABOO #PRINT BYTE 
01C0 78 MOV AyE gGET BYTE AGAIN 
O1C1 FEOA CFI LF SEND OF LINE? 
O1C3 C2B901 JNZ GLOOF 7NO 
O1C6 3AD604 LIA LCOUNT <sGET COUNT 
O1C9 3C INK A INCREMENT IT 
O1CA 320604 STA LCOUNT <sSAVE IT 
O1C0 FE42 CFI LMAX 9TOO MANY? 
O1CF 143202 CNC NPAGE 5YES» RESET 
O12 3SADBO4 LDA FFLAG sFORM FEEDS? 


eee eeeeeeermnnneteteetteemmeeneaneneeneeneneneerneeemmiemmmnnaennntamemnenetmmnemmmmmmemaanereannerinneeenecerenen nn namtenatecmmnmenae nee eenenennea nen SST TENE 
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OLDS 
O106 
O1ngs 
oi1nc 
OLDE 
OLE] 
O1E4 


O1E?7 


B7 
CABIO1 
BAD604 
FE3A 
DABIOL 
CHLIBO2 
COF601 
CBE901 


ES 

nS 

C3 
OEOR 
ChOS00 


060A 
SAD4604 
3C 

3C 
3201604 
CHO302 


78 


ES 

0S 

CS 
OEOS 
oF 
FEOC 
C2EFOL 


BALISO4 
4F 
CD3202 
3E42 
91 

ng 


A 
JZ GLOOP 
LDA LCOOUNT 
CFI LINES 
JC GLOOP 
CALL FILL 
CALL TWOLN 
JMF GLOOP 
¥ 
§ CHECK FOR ABORT» ANY 
? 
ABORT: FUSH H 
PUSH D 
PUSH RB 
MVI C» BRKF 
FCHAR2: CALL BROS 
FOF B 
FOP i 
FOF H 
RET 
3 
TWOLN? MMVI BeLF 
Lia LCOUNT 
INR A 
INR A 
STA LCOUNT 
OUTT2$ CALL OUTT 
? 
OUTTS MOV AB 
¥ 
§ SEND CHARACTER FROM A 
9 
FCHAR: PUSH H 
FUSH th 
FUSH B 
MVI Cr TYPEF 
MOV EvA 
CFI FORMFTI! 
JNZ FCHAR2 


FILL OUT PAGE 


“Sp “Gs “ae 


CALL 
mVi 
CALL 
FOF 
POF 
FOF 
RET 


“Tj ~ar ~a> ~ap 


ILL: LDA 
MOV 
CALL 
NVI 
SUB 
RC 


9NO 
§GET 
SEND 
§NO 
§NEW PAGE 


COUNT 
OF FAGE? 


KEY PRESSED 


9 SAVE 


gCONSOLE READY? 


jRESTORE 


sTWO LINES 


sALDL 2 TO 
§ COUNT 


SDOUBLE OUTFUT 
SOUTFUT FROM B 


TO LIST 


9 SAVET 
gLIST 


sFORMFEED? 
gFPRINT BYTE 


AFTER FORMFEED 


FILL 
Ro LF 
OUTT 
B 
D 
H 


FILL OUT END OF FAGE 


LCOUNT 
CrA 

NF AGE 
Avy LMAX 
C 


sFOR FORMFEED 


sLINE COUNT 


gINCR PAGE 


7T00 BIG 


0226 
0227 
0228 
022A 
O22Tt 
O22E 
0231 


0232 


0233 


0236 


0239 
023A 
023D 


O23E 
0240 


0243 
0246 
0248 


O24B 
O24AE 


O24F 
0250 
0252 
0253 


0256 
0257 
025A 
0258 


O25C 
0250 
O25E 


O2SF 
0260 
0263 
0264 
0245 
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320704 
c9 


OEO? 
C30500 


SADEO4 
FE8O 
C24FO2 


CONA02 
AF 


218000 
19 
7E 


Ed 
23 
cy 


23 
220004 


S> Gp “OD 


“a> “MIP “ap 


Gy «a> sar as 


RZ 

MOV CrA 

NVI BeLF 

CALL OUTT *SEND LF 
IiCR C 

JNZ FILL2 

RET 


LINE COUNT» INCREMENT PAGES 


XRA A 9GET A ZERO 
STA LCOUNT ¢LINE COUNT 
LIA FAGES sPAGE COUNT 
INR A 

STA FAGES 

RET 


MESSAGE TO CONSOLE 


MVI C»PBUF 
JMP BDOS | 


GET NEXT BYTE FROM DISK BUFFER 


LDA IBF 
CFI 80H 
ANZ READ 


READ ANOTHER BUFFER 


CALL DISKR 
XRA A 


READ THE BYTE AT BUFF+REG A 


MOV EvA 
MVI Ded 
INR A 

STA IBP 


POINTER IS INCREMENTED _ 
SAVE THE CURRENT FILE ADDRESS 


FUSH H 

LXI H» RUFF 
DAD Ih 

MOV As 


IS IN THE ACCUMULATOR 
RESTORE FILE ADDRESS ANDI INCREMENT 


FOF H 
INX H 
RET 


BYTE FROM MEMORY BUFFER 


FUSH H 
LHLD BUFFP 
MOV AxyM 
INX H 


SHLI BUFFF 
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0248 El FOP H 

0269 E67F ANI 7FH ySTRIP FARITY 

O26B FELLA CPI. EOF 

0260 CO RNZ 

O26E Fi POF FSW SRAISE STACK 
¥ 

O26F SANSO4 LDA FULL sCHECK FLAG 

0272 7 ORA A b ZERO? 

0273 CABEO2 JZ FINIS gYES» DONE 

0276 CH7CO2 CALL RESET sFOINTER 

0279 C36401 JMF MAINS *GET MORE 


RESET MEMORY FOINTER 


_027C ES ESET: PUSH H 

O27D 210005 LXI H» BUFFER 
0280 220004 SHLD BUFFF 

0283 El FOF H 

0284 C9 RET 

? 

0285 110204 NONAMNE: LXI DyMESI sPOINT TO MESSAGE 
0288 CUSEO2 FINTI33 CALL PRINT 

O28B CSAEO2 JMF ABOR2 


NORMAL END OF OF LISTING 


O2BE 320404 INIS: STA EOFFL gSET EOF FLAG 


ser “FP wae ce a> 


0291 CHIBO2 . CALL FILL sOUT FAGE 


ADD AN EXTRA PAGE IF THERE IS AN OLD NUMBER 
AND F FLAG IS NOT SET 


Sp Ms IS “GD 


0294 ZADI04 LBA PFLAG 


0297 B? © ORA A 9 ZERO? 
-0298 C2AE02 JNZ ABOR2 9NO 

O29B 3AD704 LDA PAGES sHOW MANY? 
O29E E601 ANT 1 sODLT 

O2A0 CAAEO2 JZ ABOR2 3NO 


AND BLANK FAGE TO MAKE EVEN 


G> ap We “ae 


(CAN WE CALL FILL?) 


O2ZA3 0642 MVI BeL MAX #LINES 
O2AS SEOA EPAGE: MMVI ArvLF 
O2A7 ChO402 CALL PCHAR 
O2AA O05 DCR B 
O2AB C2A502 JNZ EPAGE 
9 
ABOR2: 
ABORS 3 
O2ZAE 2AEOO04 LHLD OLDSF gOLD STACK FOINTER 
O2B1 F9 SPHL 


O2B2 C9 RET 


5 
y SETUP FILE AND OPEN FOR INFUT 
9 


0283 
O2BS 
0288 


O2BE 
o2Bn 


0200 
O2C1 
0204 


0205 : 
0208 | 


0209 
O2CRB 
O2CE 
O20 
O24 
0207 


O2DA 
O208 
O2Tc 
O2nNn 
O2E0 
O2E2 
OOZES 
OOZES 
O2E7 
O2E8 
O2BE9 


O2EA 
O2EC 


O2EF 
O2F2 


O2FS 
O2F8 
O2FA 
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115C00 
OEOF 
ChOSs00 


FEFF 
CACSO2 


AF 
327000 
C9? 


226800 
115000 
C38802 


ES 

DS 

cs 
115C00 
OE14 
CHOS00 


111104 


C3AEO2 


2ALIICO4 
361A 
C3A101 


SETUP: 


“> “I> “Gp 


> Sp “NID 


Ret wae ses sae 


a> 


“S> “> “Up “ap 


ALOFN: 


ISKR3 


END: 


LXI 
MVI 
CALL 


CHECK FOR 


CFI 
JZ 


OPEN IS OK 


XKA 
STA 
RET 


BAD OFEN 


LXI 
MOV 
CFI 
JZ 
LXI 
SHLI! 
LXI 
AMF 


REATI 


RZ 
MAY RE EOF 

CFI 

JZ 


LXI 

JMF 
FOUND DISK 
LHLD 
MVI 
\ SMF 


ItyFCR 


CsOFENF 


BOOS 


ERRORS 


2 


BALIOFN 


FCBCR 


H»FCBFN 


Aol 


é 


NONAME 
He “?P$¢ 


FCBRL 


hy FCBFN 


FINIS 


ISK FILE RECORD 


H 
4) 
B 
Dy FCB 


Cs READF 


Bros 
BR 
i 
H 
A 


1 
FENT 


Die MES2 


ARBORS 
EOF 
BUFFF 


Me EOF 
MAINS 


TAR COUNTER ROUTINE 


JUMF 
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#NO GOOL 


31ST CHAR 

$GET IT 

$FILE NAME? 

3NO 

3SET UP FOR PRINT 
SUSE INFUT FILENAME 
}F ILENAME 

SQUIT 


#CHECK FOR ERRS 


9OK 


gE OF 


§GET FOINTER 
sFUT IN 1A 


HERE WITH BYTE IN B 
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O2FT 
O2FE 
0300 
0303 
0306 


78 
FE20 
DALEOS 
CH0903 
C30302 


SAD2Z04 
3C 
E607 
320204 
Cc? 


CDLRO2 
OEO1 

ChOS00 
C3AEO2 


320204 
030302 


FEO? 
C24003 
CNS803 
CDO903 
C23603 
Ce 


FEOC 
C20302 
SAL804 


C31B02 
Fi 
C3B90O1 


TABO S$ 


INCREMENT TAB 
MAKE MODULO 8 


= “Gp we GP a> 


LIA 
INR 
ANI 
STA 
RET 


ABN: 


9 
’ REAL THE BYTE 
3 


CALL 
MVI 
CALL 
JMF 


DONE ¢ 


ArB §GET BYTE 

voi ICONTROL CHAR? 
TABCR 7YES 

TABN ¥INCR COUNTER 
OUTT sSEND BYTE 
COUNTER 

TABC *GET TAR COUNT 
A sINCREMENT IT 
7 ‘MODULO 8 

TABC ySAVE IT 

AFTER ABORT 

FILL sOUT PAGE 
C»yCONS #READ CONSOLE 
BOS 

ABORS yRETURN 


5 
’ IF CARRIAGE RETURN THEN ZERO COUNT 
3 


TABCR: CFI CR 
JINZ TABI yNOT CR 
CALL ABORT 
RRC sKEY PRESSED? 
JC TONE pQUIT 
XRA A 9GET A ZERO 
STA TABC *SET TO ZERO 
JMP OUTT *SENTD CR 
y 
* CHECK FOR TAB (CONTROL-I) 
? 
TABI: CFI TAB 
JNZ TFORM sNOT TAR 
TAB2? CALL BLANK *SEND A BLANK 
CALL TABN §INCR TAR COUNT 
JINZ TAB2 9MORE 
RET §NO FRINT 
g 
’ CHECK FOR FORMFEED 
9 
TFORM: CFI FORMFD 
JINZ OUTT 9NO 
LDA FFLAG sFORM FEEN OPTION? 
ORA A 
JINZ TFOR2 sOTHER CONTROL 
MVI Be LF 
CALL OUTT 
ME FILL gNORMAL FORMFEED 
TFOR2: FOF FSW *RESTORE STACK 
JMF GLOOF #NEXT BYTE 
y 
y SEND A BLANK ‘ 
y 
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0358 3E20 BLANK?2 WMVI Ay’ ¢ 
O35A C30402 JMP PCHAR *SEND IT 

7 
O35D DBC4 CLOCK: IN ADATA *BOARD FRESENT? 
O35F FEFF CFI OFFH 
0361 C8 RZ >NO 
0362 JANIIO4 LDA TIME2 sPASS? 
0365 B? ORA A # ZERO? 
0346 C8 RZ #NOT 15ST 
0367 AF XRA A 
0368 320304 STA TIME2 sSET 15ST 
O36B 210E03 LXI H+» MON 
O36E CDA703 CALL NATE sGET IT 
O$71 21EN03 LXI H» HOUR 
0374 ChClOOS CALL TIME 
0377 211703 LXI HePOATE §FOINT DATE/TIME 
O37A CDBA03 CALL SEND 
O370 AF XRA A 9GET A ZERO 
O37E 324900 STA FCB+13 sNAME END 
0381 215000 LXI H»FCEFN 5 NAME START 
0384 CUBA0DS CALL SEND *SHOW 
0387 21FFO3 LXI Hy SCRLF | 

9 

§ SEND MESSAGE TO LIST 

9 
O38A 7E SEND3 MOV Ag #GET BYTE 
O38B B7 ORA A sZERO AT END 
O38C C8 RZ §’ DONE 
O38D CDO402 CALL FCHAR sSEND CHARACTER 
0390 23 INX H sINCREMENT POINTER 
0391 C3B8A03 JMPF SEND 

3 

§ READ A DIGIT 

9 
O394 7A ROIGITs MOV Art *SELECT DIGIT 
0395 03C4 OUT ALATA 
0397 DEC4 IN ALATA PRESET INTERRUPT 
0399 DRCS DWAIT? IN ACONT *DUIGIT PRESENT? 
O39R E680 ANT BOH 
O39D CA9903 JZ DWAIT §LOOP UNTIL READY 
O3SA0 DIBC4 IN ALATA #READ A DIGIT 
O3A2Z ESOF ANI OFH yMASK 
O3A4A F430 ORI 30H sCONVERT TO ASCII 
O3AG CI RET 

9 

*READ-DATE ROUTINE 

tf 
OSA7 AF DATE: XRA A sDATE DISFLAY MODE 
OSAS TCS OUT BLATA 
O3SAA 4F MOV CrA #THIS IS DATE 

3 

* REAL FOUR DIGITS 

? 
O3AER 1600 REAT4; MVI Iie ¥SELECT FIRST DIGIT 
OSAD CN9403 RDAs CALL ROIGIT sDELAY ONE DIGIT SCAN 
O3BO COCHOS CALL RSOIG sREAD & STORE DIGIT 
O3B3 7A MOV Avt 
O3B4 FE20 CFI 20H #TWO DIGITS DONE? 


smear eaameainereeatnnnaneneeenieeeentemmeimeemennnnnatanemenemmemmmmmennnane cennemeenescenmanr emeeeeeeemerpemmneegr nearer arenennnee mena ne eT EN EIEN ETE HETERO NTE UE EET UU OEE UNIO UTLET VY 
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O3R4 C2BA03 JINZ SKIF §SKIF A FLACE 
O3RB9 23 INX H sSKIPF ¢ OR / 
O3BA FE40 SKIF 3 CPI 40H 
O3SBC C2AN03 JNZ RE4 sGET ANOTHER NIGIT 
O3BF C9 RET 
g 
; REAL TIME & READ AND STORE DIGIT 
¥ 
03C0 JE40 TIME? MVI Ay 40H sTIME DISPLAY MODE 
O3C2 DNSCé ; OUT BATA 
0304 OEOL MYT Cel sTHIS IS TIME 
0306 COAROS CALL REALA sGET 4 BIGITS 
O3C9 23 INX H ¢SKIF COLON 
O3CA CUCHOS CALL RSDIG 
O3CH Ch9403 RSDIG CALL ROIGIT 
O3n0 77 MOV MrA §STORE BYTE 
O31 23 INX Ho SINCK FOINTER 
O32 7A MOV Asli 
O3n3 C410 ALT 10H 
0305 37 MOV DA 
O306 C® RET 
y 
sSTORAGE AREA 
ba 
FOATE? 
O3N7 O10A446174 NB CRyoLF ys “Tlate ” 
OSDE 78782F MON? ne nS §MONTH 
O3E1 78782F De “wns 7 5 DAY 
O3E4 3830 WB “80° 3 YEAR 
OSES 202054696D De ‘ Time ” 
OSEN 78783A HOUR? Qk “yes / S5HOURS 
O3FO 78783A DB “exe 7 MINUTES 
OSF3 7878 DE “MM sSECONTS 
OSFS 2020204669 tre File? ‘99 
O3FF OL0A00 SCRLF3 1B CReLF 0 
0402 ODOA4SESF2OMESL? DB CReLFe’No file names’ 
0411 ODOA444973MES2 3 OB CReLFs ‘Disk errors’ 
O41E OD0A RULES? - IB CReLF 
0420 30726F 6772 Ig ‘Frodram to list ASCII files’ 
O43B ODOAZO4F70 DB CReLFs’ Ortions? ’ 
0446 2028636846F ne ‘ (choose one)’ eCReLF 
0455 2020462041 BS) ’ F adds form feeds’ »sCRe LF 
046A 2020502073 LE ‘ F skies extra even race’ 
0483 2061742065 DE ’ gt end’ sCReLF 
O48C 2020446563 DB ‘ Decimal mumber skies ” 
0443 6C4696E46573 DB ‘lines at bedinnina’ »>CReLFo LF 
O4B8 2050726573 DB ‘ Fress any key to abort.’ 
0400 OA24 DB LF‘? 
9402 00 TABC? DB 0 §TAB COUNTER 
04n3 80 TIME2? OB 80H sFPASS 
. 0404 FF EOFFL: DB OF FH sEQF FLAG 
0405 00 FULL? DE 4) FULL FLAG 
0406 02 LCOUNT? DB 2 sLINE COUNT 
0407 00 FAGES: DB 0 #FAGE COUNT 
0418 00 FFLAG? DB 0 sFORMFEED FLAG 
~ 9409 00 FFLAG? DB ¢) PEXTRA~FAGE FLAG 
040A 0000 SKIFB? DW 9) sLINES TO SKIF 
O4DC 0005 BUFFF? [DW BUFFER $¢FOINTER 
O4TE TRF? nS 2 SINPUT BUFF FOINTER 
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3 
9 STACK AREA 
O4E0 OLUSF?3 hs 2 yOLO STACK 
O4E2 DS 30 §STACK SPACE 
STACK: jNEW STACK 
0300 RUFFER? 0S 1 sMEMORY BUFFER 
? 
OS01 END 


LIST can be executed by the command 
ASLIST <filename> “ortional argument 


The CP/M system copies LIST into memory at 100 hex and branches to it. 
The first step is to save the incoming stack pointer and set up a new one. The 
clock routine is executed next. The routine shown in Listing 10.2 is written 
for a Computime R clock board, but the program can be altered to accommo- 
date other methods of timekeeping. The first step of the clock routine is to — 
see if there is a clock board in the computer. One of the clock ports, at 
address ADATA, is read. If there is no port at this I/O address, the computer 
will read a value of FF hex. This will harmlessly terminate the subroutine 
with a return instruction. 

If a clock board is present, then the first line of the printer output will 
appear in the form 


Nate 06/15/80 Time 13318:33 FILE? <filename> 


The next step is to see if one of the three optional arguments was ewer after 
the filename. These arguments are: 


F (add form feeds) 
P (no extra page at end) 
decimal number (skip lines at beginning) 


The letter F is used to insert form feeds every 58 lines of the listing. The 
command looks like this. 


AsLIST SORT.PAS F - 


This feature is useful for listing BASIC, FORTRAN, Pascal, or assembly- 
language source programs. If this argument is selected, the proper number of 
line feeds is generated as the end of the page is approached. This step causes 
the printer to skip over the fold in the paper. Also, any form feeds that are 
encountered are ignored. 

If the letter P is given for the argument, then no extra Blake page is 
generated at the end. This argument can be used to save paper when several 
one-page files are printed. 


242 8080/Z-80 ASSEMBLY LANGUAGE 


Another possible argument to LIST is a decimal number. In this case, 
the argument tells how many lines of the file are to be skipped. For example, 
the command 


~APLIST LINFIT.FOR 500 


will skip the first 500 lines and start the listing with line 501. Use this option 
-if you want to print the last part of a long file but don’t want to wait for the 
first part to be printed. 

At this point, the disk directory is searched for the requested filename. 
This filename is retrieved from the file-control block at address 5C hex. If 
the requested filename can’t be found in the directory, then the filename is 
printed on the console along with a question mark. LIST is then aborted. If 
no filename was entered, an error message stating this fact appears on the 
console. LIST is aborted in this case also. LIST could have been programmed 
to handle input errors the way that the GO routine does. Then, instead of 
aborting, LIST would ask for the filename to be entered again. The addition 
of this feature is left as an exercise for the reader. 

If the filename exists in the directory, then the requested disk file is 
read. The proper number of lines are skipped over if the second argument of 
the command line was a valid decimal number. At this point, the disk file is 
read into memory. The FDOS address located at address 7 is checked to see 
how much memory is available. The entire file will be copied into memory 
if there is room. A check is made to see if the disk end-of-file character is 
encountered before the available memory is filled. 

In either case, the date and time of day are printed first. Then the data 
in memory are printed. The first character is ignored if it is an ASCII form 
feed. This will prevent a page eject immediately after the date and time. The 
ASCII tab character is properly expanded by the routine TABO. The number 
of lines is counted. When a form-feed character is encountered, the proper 
number of line feeds is issued to fill out the page. If the F argument was 
given, the form feeds will be automatically issued. 

LIST can be aborted at any time during the printing by pressing any 
console key. The console is checked for this after each carriage return. The 
CP/M program DUMP is set up a little differently. The disk data are read 
into a 128-byte buffer, rather than into the memory area above 100 hex. 
Using a small buffer has the advantage that programs can be stored in mem- 
ory during the DUMP operation and they will not be erased. But, in return, 
there is a lot of disk activity. The disk must be accessed every 128 bytes. 


COPY A DISK FILE INTO MEMORY 


If you have programmed one of the tape routines given in Chapter 8, then 
you can make backup copies of your disk files. But you have to first copy 
the disk file into memory. The copy step can be performed with the debug- 
ger DDT or SID. 
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A*SID <filename> 


This command loads the debugger at address 100 hex and branches to it. The 
debugger relocates itself into high memory, then copies the requested disk 
file into memory starting at 100 hex. The address of the end of the disk file 
in memory is printed in hexadecimal. This address can be used in conjunc- 
tion with the memory map given in Appendix B to determine the number of 
256-byte blocks in the file. For example, if DDT gives a value of 13AF, then 
the disk file occupies 19 (decimal) blocks of 256 bytes. 

When the file has been copied into memory, the G command in the 
debugger can be used to branch to the tape routine. Then the SAVE com- 
mand can be given to make a copy on tape. The process can be reversed by 
loading the file into memory from tape. Branch to address zero to restart 
CP/M. Finally, give the SAVE command 


AZSAVE XX <filename> 


where XX is the decimal number of 256-byte blocks to be saved. 

This procedure can be simplified by using the FETCH program given in 
Listing 10.3. FETCH uses CP/M for all I/O and disk operations, so it should 
work with all standard CP/M systems. There are, however, 2 items that need 
to be customized. Fetch is initially loaded into memory at 100 hex. It then 
automatically relocates itself to higher memory. The relocation address is 
chosen to be F400 hex in Listing 10.3. You may have to change it to some 
other address if this region is not available. The address is defined by the 
label ORIGIN in the source program. After FETCH copies the requested disk 
file into memory, it branches to your tape routine. This address, defined by 
the label MONIT, is chosen to be F000 hex in Listing 10.8 MONIT should be 
changed to your tape address. 


Listing 10.3. Cory a disk file into memory, 


(date does here) 


a> 


a 


ITLE ‘Cory a disk file into MEMOTYs * 


THIS FROGRAM RELOCATES ITSELF TO HIGH MEMORY THEN 
COPIES A DISK FILE TO MEMORY STARTING AT 100 HEX, 
ASCII AND COM FILES ARE CORRECTLY HANDLED. 

GIVE A THIRD ARGUMENT OF B FOR OTHER BINARY FILES. 
A 1A EQF CHARACTER IS FUT AT THE END ASCII FILES. 
THE LAST ADDRESS AND DECIMAL BLOCK SIZE ARE GIVEN. 
FINALLY A JUMP IS MADE TO THE ADDRESS OF MONIT. 


QUITS IF NO REAL-WRITE MEMORY AT NEW LOCATION 


“G> “G+ NID “Gh “Dh “Gh “OP “ED “GP sae sad am] 


FOOO = MONIT EQu OFOOOH $GO HERE WHEN DONE 

F400 = ORIGIN EQU OF400H #RELOCATE FETCH HERE 
9 

0100 = RUFFER EQU 100H #START MEMORY BUFFER 

0005 = BnOS EQU a gD0S ENTRY FOINT 
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0002 


= TYPEF EQU 
0009 = F BUF EQU 
OOOF = OF ENF EQU 
0014 = READF EQU 
ooon = CR EQU 
000A = LF EQU 
OO1A = EOF EQU 
? 
OOSC = FCR EQU 
0080 = BUFF EQU 
¥ 
3 
3 
3 
oosn = FCBFN EQU. 
00465 = FCBFT EQU 
© 0068 = FCBRL EQU 
0070 = FCBCR EQU 
¥ 
0100 ORG 1O0H 


0100 210000 EGINS LXI 
0103 39 lan 
0104 22AEFS SHLD 
0107 31C8FS LXI 
O10A 210001 LXI 
O10D 22A9F5 SHLD 


“SS “EP “a> 


0110 112A01 ~ LXI 
0113 2100F4 LXI 
0116 O1ACO1 LXI 
0119 1A LOOP: LDAX 
O1LA 77 NOV 
O11B BE CMF 
O11C C20000 JINZ 
O11F 23 INX 
0120 13 INX 
0121 OB DCX 
0122 78 MOV 
0123 Bl ORA 
0124 €21901 JNZ 
0127 C3O0OF4 JMF 

y 

ORIGINAL START 

¥ 

OLDST: 

9 
F400 ORG ORIGIN 


y 
F400 C346F4 START3 JMF 
F403 CDOBF4 FINIS: CALL 
F406 2AAEFS LHLO 
F409 F9 SPHL 
F40A C9 RET 


2 yCONSOLE OUTFUT 

9 gFPRINT CONSOLE BUFFER 
1S gFILE OFEN 

20 sREAD FUNCTION 

ODH yCARRIAGE RETURN 

OAH gLINE FEED 

1AH gEND OF FILE 

SCH gFILE CONTROL BLOCK 

80H INPUT DISK BUFFER ADDR 


FILE CONTROL BLOCK DEFINITIONS 


FCBt1 pF ILE NAME 

FCR+9 gFILE TYPE 

FCR+12 sCURRENT REEL #@ 
FCBt32 ‘s¢NEXT REC #@ (0-127) 


SAVE OLD STACK AND SET UP NEW STACK 


Hed yZERO HL 

SF gADND IN STACK 
OLUSE SAVE STACK 
SPySTACK sDEFINE NEW STACK 
He BUFFER 

BRUFFP sMEMORY FOINTER 


BLOCK MOVE REST OF FROGRAM 


DeOLUST sOLD START 
HySTART #NEW START 
Bey ITBP-START sLENGTH 


I ‘GET BYTE 

MA *MOVE TO NEW 
M sCHECK MEMORY 
0 gQUIT> BAD 

H § INCREMENT 

I ¢ FOINTERS 

B sHECR COUNT 
Ayk ¥SEE IF DONE 
C sALL MOVED? 
LOOP §NO 

START ’ NONE 

OF FROGRAM 

MAIN gFINAL START 
CRLF 

OLDSF ORIGINAL STACK 
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F40B SEOD 
F400 Cpol2F4 
F410 3SEOA 


F4i2 ES 
F413 05 
F414 Cs 
F415 OEO2 
F4i? SF 
F418 CHOSs00 
F41k Cl 
F4ic 01 
F4itr €1 
F4i1E C9 


F41F ChOBF4 


F422 ES 
F423 OEO9 
F425 ClOSO00 
F428 El 
F429 C9 


F424 3AACFS 
F420 FESO 
F42F C236F4 


F432 COSSFS 
F435 AF 


F436 SF 
F437 1600 
F439 3C 
F43A 32ACFS 


F430 ES 
F43E 218000 
F441 19 
F442 7E 


F443 El 
F444 23 
F445 C9 


$ 
CRLF é MVI 
CALL 


MVI 


A»CRK 
FPCHAR 
AvLF 


3 
§ OUTFUT A CHARACTER FROM A 
3 


PCHAR 


CARRIAGE RET» 


"RINTCS CALL 


sap sco co "FE se> ~<a sep 


bas 3 


PUSH 
MVI 
CALL 
FOF 
RET 


‘RINT? 


GET NEXT BYTE 


Cy osc a> «> 


NE? LA 
CRI 
INZ 


ah “I> “ED 


CALL 
XRA 


REAL THE EYTE 


G3 sar er scp 


0% MOV 
MVI 
INK 
STA 


“Sh “Cp 


PUSH 
LXI 
DAv 
MOV 


“ab NED 


FOF 
INX 
RET 


B *>SAVED 


H yRESTORED 


LINE FEED AND PRINT 


CRLF 


PRINT BUFFER UNTIL $ FOUND 


H 
CrP BUF 


FROM DISK BUFFER 


TBE 
80H 
GO 


READ ANOTHER BUFFER 


QNISKR 
A 


AT BUFFIREG A 


EvA 
Tly9 
A 

IBF 


FOINTER IS INCREMENTED 
SAVE THE CURRENT FILE ADDRESS 


H 

Hy BUFF 
ri 

Avi 


BYTE IS IN THE ACCUMULATOR 
RESTORE FILE ADDRESS AND INCREMENT 


H 
H 
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CLLGF 4 
SE80O 
S2ACFS 


 CO2ZAF4 


ES 
ZAAPFS 
77 
23 


22A9FS 


. C24EFA 


78 
FELA 
C24EF A 
ZAAPFS 
ok 
LIBAFS 
COU22F4 
COBIF4 
LI99FS 
CU22F4 


7C 
2600 
1644 
OE 2F 
oc 

92 
N292F4 
B2 

47 

79 


FES1 
N2AaSrA 
7C 

B7 


AIN: 


REAL BYTES 


“ce “ae ar "Yar 


CALL 
MVI 


a 


? 


MAIN4? FOF 


MAINS: CX 
DONE: LXI 


Sr “I> Se 


MOV 
MVI 
MVI 
HM33 MVI 
HM2¢ INR 
SUB 
JNC 
ADL 
MOV 
MOV 


Se Sp “Ee 


CFI 
JNC 
MOV 
ORA 


FROM DISK 


SE TUF 
Ay 80H 
IBF 


BrA 


TOORIG 


H 
EFLAG. 
A 
MAIN2 
Avs 
EQF 
MAIN? 
RUFFF 
H 

Thy MESA 
FRINT 
OUTHL 
tly MESE 
FRINT 


AvH 

Hy O 

[ly 100 
Cr /O% 1 
C 

ih 

HM2 

a] 

BeAé 
~Asl 


GA! 
HMN4 
AvH 
A 


AND FUT IN MEMORY 
ySET UP INPUT FILE 
sRUFFER FOINTER TO 80H 
9GET A BYTE 


¥MEMORY FOINTER 
gFUT BYTE IN 


§SAVE FOINTER 


gL=O? 

yNO 

gF DOS 

gCCr <1 
#TOO BIG? 
gWON’T FIT 


gRINARY FILE? 


gYES 
gGET BYTE 


9NO 
yPOINTER 


gP RINT IT 


CONVERT FILE LENGTH TO DECIMAL K 


gLEADING O FLAG 


9100/10 

9STILL PLUS 
FALL BACK 

§SAVE REMAINIIER 
*GET 100S/TENS 


SUFFRESS LEADING ZEROS 


sLESS THAN 1? 
¥NO 

gCHECK FLAG 
¥ZERO?P 
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79 
CAAAF 4 


3 COAL 4 


26FF 
7A 
L46SA 
37 

78 
290F 4 
C630 
COL2F4 
CHOBF4 
C300F0 


4C 
CHC2r4 
4f 


iF 
CUCBF 4 
79 
ESOF 
C490 
27 
CE40 
27 


C312F4 


S2ABFS 


S2ABFS 


115C00 
OEOF 
ChOS00 


FEFF 
CAQEFS 


MOV Ayl #RESTORE BYTE 
JZ HMS 9IF LEADING 0 
HM43 CALL FCHAR 91ST» 2NU DIGIT 
NVI HesOFFH §SET FLAG 
HMS3 MOV Avlt 
SUI 70 ¥100 TO 10 
MOV DyvAa 
MOV Ayk 
JNC HMS ¥ONCEMORE 
Abul “O° yASCITI BIAS 
CALL FCHAR 93R0 DIGIT 
CALL CRLF 
JMF MONIT DIONE 
? 
¢ CONVERT BINARY IN Hel TO ASCII HEX 
¥ 
QUTHL: MOV CyH 
CALL OUTHX 
MOV Cyl 
OUTHX: MOV AyC 
RAR 
RAR 
RAR 
RAR 
CALL HEX1 
MOV Aryl ' 
HEX: ANI OF H VOUTPUT HEX RYTE 
ALT 9 OH 
TAA gINTEL TAA TRICK 
ACI 40H 
DAA 
JME FCHAR 
# 
§ SETUP FILE ANU OPEN FOR INFUT 
§ CHECK FOR BINARY FILE 
y 
SETUFs XRA A ¥ZERO 
STA BFLAG gNOT BINARY FILE 
LHLD FCBFT gF TLE TYPE 
MOV Agk #1ST CHAR 
CFI mee 
JNZ BINCH gNO 
MOV AyH ¥SECOND CHAR 
CFI 5a) 8 is 
JINZ BINCH 7NO 
OPN: NVI As EOF gSET FLAG 
STA BF LAG 
9 
¢ SETUP FILE AND OPEN FOR INFUT 
? 
OFNS3 LXI Thy FCR 
MVI Cs QFENF 
CALL RLOS 
¥ 
§ CHECK FOR ERRORS 
y 
CFI 255 
JZ BANOFN $§NO GOOK 
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FA4FB AF 
F4FC 327000 
FA4FF C9 


FSO00 2146100 
FS03 7E 
F504 E657 
FS06 FE42 
FS08 C2EEF4 
FSQOB C3E9F4 


FSOE 215000 


FS14 CA26FS. 


FS17 213F 24 
FS1A 224800 
FSin 115D00 
FS20 CU22F4 
FS23 C303F4 


F526 1162F5 
F529 CDIFF4 
F52C C303F4 


32 C329FS 


FS35 ES 
F536 05 
F537 CS 
FS38 115C00 
FS3B OE14 
F530 CHOS0O0 
F540 Cl 


F545 FEOL 
FS47 CASSFS 


FS4A LI6FFS 
FS40 ChIFF4 
F550 C303F4 


2F LLZAFS | 
3 


‘S> SP GD 


OFEN IS OR 


XRA 
STA 
RET 


INCH: LXI 
MOV 
ANI 
CFI 
JNZ 
JMPF 


BAD OPEN 


ADOFPN$ LXI 


a 


y 
NONAME: LXI 
NONAM2: CALL 


wnt ar 


OOBIG? LAT 


ISKRS FUSH 
PUSH 
PUSH 
LXI 
MVI 
CALL 


MAY BE EOF 


“> “E> “aD 


CFI 
JZ 


=> “> “Ge 


LXI 
CALL 
JMF 


A 
FCBCR 


BR FOR THIRD ARGUMENT MEANS BINARY FILE 


Hy 60H 

Avil *GET THIRE ARGUMENT 
v7 H SLOWER TO UFFER 

“Re ; 

OFNS #*NOT BINARY 

OFN2 + RINARY 


Hy FCBRFN #15T CHAR 


Avi IGET IT 

mae sFILE NAME? 
NONAME ¢NO 

He “PS FSET UF FOR PRINT 


FCBRL sUSE INFUT FILENAME 
[iyFCBFN ¢ FILENAME 

FRINT 
FINIS PQUIT 
DiyMES1 *FOINT TO MESSAGE 
FPRINTC 

FINIS 


IlyMES4 
NONAM2 


READ UISK FILE RECORD 


liyFCR 

Cy READF 

EOOS 

13 

8] 

H 

A CHECK FOR ERRS 
gOK 


1 
FENDI vEOF 


INCORRECT FILE NAME 


Dy MES2 
PRINTC 
FINIS 
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ne EEE 


FOUND DISK EOF 


“Ty <r scp sap 


FOSS 2AARFS END? LHLD BUFFF *GET FOINTER 


F556 3AABFS La BFLAG  #COM FILE? 
F559 B7 ORA A 

FSSA C27BF4 JNZ MAINS YES 

F5SD 361A MVI MeEOF  $FUT EOF 
FSSF C37CF4 JMF DONE 


STORAGE AREA 


“She “> “KP 


F562 4E6F2064669MES12 DB ‘No file names’ 
FS6F 44697346R20MES23 DB ‘Disk errors’ 
F3S7A 46696C4520MES4 3 DB ‘File is too bis’ 
FS8A 4C0461737420MESA? IB ‘Last address? $° 
F399 206865782CMESE3 as ‘ hexy Blocks? $7 
FSA? 0001 BUFFPFS DW BUFFER sFOINTER 
? 
FSAR RFLAG? OS 1 yRINARY FLAG 
FSAC IBF: ns 2 SINFUT BUFF FOINTER 


STACK AREA 


FSAE LOSE: 0S 2 sOL0 STACK 
FSBO : DS 24 §STACK SPACE 
STACK? 
3 
FScs END 


One of the advantages of FETCH is that it is considerably smaller than 
DDT or SID. In addition, the decimal number of blocks to be saved and the 
last address of the program are given. FETCH is executed just like the 
debugger. 


ASFETCH <filename>.<extension®> 


The CP/M system loads FETCH at 100 hex and then branches to it. The 
instructions at the beginning of FETCH are used to relocate the rest of the 
program into a preselected memory area. A jump is then made to the Fee 
cated FETCH. 

FETCH loads the selected disk file into memory starting at 100 hex. 
An ASCII file is copied up to the 1A end-of-file mark. Typical extension 
names include the following. 


ASM (assembly language) 
PAS (Pascal) 

FOR (FORTRAN) 

BAS (BASIC) 

HEX  (hex-encoded binary) 
TEX — (text formatter) 

LIB (library) 

MAC (assembly language) 


LL LLL LLL TANTRA RETR EN CR ARLA HR eee teneeetalnneetntansisternnesnmeshn tthe mnt tmrniasmmensndamententsit 
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Executable binary files will have a file extension of COM; the entire file will 
be copied in this case. If a nonexecutable binary file is loaded, an additional 
argument of B (for binary) must be given. 


FETCH SORT.REL & 


Examples of executable binary files are 


REL (relocatable) 
INT (intermediate) 


Relocatable files generated by the Microsoft assembler, and the FORTRAN, 
COBOL, and BASIC compiler are of this type. Intermediate files are pro- 
duced by CBASIC. 

After the disk file is loaded, FETCH prints two numbers. One number 
is the memory address of the end of the file expressed in hex. The other 
number is the size of the file. The number of 256-byte blocks is printed, 
in decimal. 

Type up the program given in the listing. Assemble it and load it into 
memory with the debugger 


A>ONT FETCH.HEX 


The debugger will load the move routine, the first part of FETCH, into 
memory at 100 hex. The main part of the program, however, will be loaded 
at the address of ORIGIN, OF400 hex in this case. Use the debugger to move 
the main part of FETCH back down to the beginning of the user area. 


MF400 FSFF 212A 


Now, return to the CP/M system with a control-C and save the combination 
of the move program and the main part of FETCH. 


A>SAVE 2 FETCH.COM 


FETCH is now ready for use. 
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APPENDIX A 


The ASCII Character Set 


The ASCII character set is listed in numerical order with the corresponding 
decimal, hexadecimal, and octal values. The control characters are indicated 
with a caret (A). For example, the horizontal tab (HT) is formed with a 
control-I. 


SOS ST SPE See Stee eee cere cece meee meee mee mere reew sane eee cowe etme ome sae eres sete See Suns Gute fame Meme ane wee Sumy Seen fend mabe Med ome one seey cue same seve cogs vena seus cone some sens meme cpm suet anew unt nee 
Save mons aime even coy Caos Sree Soun sont men cane ties Gees enue Gwe OUhe OOD SOS asus ares Meet crea Sune swat Wuee Gms seme aunt mate Seee fons cone coe Stee Sous Same Sire nes Secs ine tees Sled Shed thes Snes snen seen song 


NUL O 00 000 “@ Null . @ 44 40 100 
SOH iI O1 001 “A Start of heading A 65 4l 101 
STX 2 02 002 “BR Start of text RB 66 42 102 
ETX 3 03 003 "CC End of text Cc 6&7 43 103 
EOT 4 04 004 “D End of transmission Qn 48 44 104 
ENQ 5 OS 003 “E Eneuiry E 69 45 105 
ACK & 06 006 “F Acknowledge F 70 46 106 
BEL 7 07 007 “G Bell G 7i 47 107 
BS 8 08 010 “H Backsrace H 72 48 110 
HT 9 Og 011 “I Horizontal tab I 73 49? 111 
LF 10 OA O12 “J Line feed ra 74 4A 112 
VT ii OB 013 “K Vertical tab K 75 . 4B 113 
FF 12 oc 014 “L Form feed L. 76 4C 114 
CR 13 on 015 “M Carriage return M 77 4T) 115 
SO 14 OE 016 “N Ghift out N 78 4E 116 
SI i15 OF 017 “0 Shift in 0 79 4F 117 


SORE SESE SES See Sees sees sts Sees cree mace save cone come snee seve neue waen oned outs mune some cont test Stee Heme oan sare wen Atte Ret WOOO Bet) stan com Gave aénd suas weer ‘Sect ence even seve save mame wren see quee gene menu gees sete rane same peer mee 
oom Tene Smet Smee neY Mew LUNN HERD LENE dnee Sunt Snes BOue mabe Sens cuen went Sued sowe Dons Some Sane cue Seem ated Same Smet Sete Sith mine GAAS ants anon cont Sent sont Glee Stee S56t Sica Ses eee cues soon soon gece ance seve cone Gee came ome 


DLE 146 10 020 “F Data link escare F 
DCi 17 li 021 "“Q Device control 1 Q 
DC2 18 12 022 “RK Device control 2 R 
OCS 19 13 023 “S Device control 3 S$ 
DC4 20 14 024 “T Device control 4 T 84 24 124 
NAK 21 15 025 “U Negative acknowledge U 
SYN 22 16 026 “V Synchronous idle V 
ETB 23 17 027 “W End transmission block W 


SSeS SOS SES See SSS Sa See es re ee See cee cee sree cree mre mee ete ree mee were eres sere wave sone enue eae ines meee o> geen bene meen even cnet cunt weed tebe feet pei mid S20r 0S SSS SSS Sess See SS Se Se SS SSS Ss SS a Se es St 
Sat Some une Sten come eenes weee Mun Stee See Sent anne Siw Seve samt Geen suee eet chee cust sont Suns Secs Soon Stew onwe Sunt Sout sco cteue Sent Sect Gees Seon Sete Seen oats Se S02 Sst os ‘Sees Suen Sime Gene Gite Shue Aone Tene MAW Sens ome SeGe eR 


CAN 24 18 030 “X Cancel X 
EM 25 19 031 “Y End of medium Y 
SUB 26 1A 032 “Z Substitute Z 90 SA 132 
ESC 27 iB 033 “€ Escare . C 
FS 28 ic 034 “\N File sererator \ 
6S 29 it 035 “J Grour serarator J 
RS 30 1£ O36 “" Record serarator a 
US 31 1F 037 “_ Unit serarator ~ 95 oF 137 


SooE SRS SOTe See Se sete sees cece sees tees core cere eret tee me meee meme smn ene meme vent meee sane vane wean tame went seme sane Spee nee vee cece nee sums suse soe Suet amet eres meee sone mune aves mene many sues sus sete 
TH eet satin Same mene Ghee See Gen Sone OUOE Sees Sine hove auut Woes MODE SOUS Que Sant Sone Stee Amer Guee Goes Seca Sone Sous cael meee Stee Sect sont Sree Gece ovat cane mone Que Sues Sane Sew sony caw stmt home Sue anes UNS Cane 
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sees erin sees mene geen ouse anew fonbh mata Sons oes umes date inet mabe Inte sews mene Denn veer Bena wane vue Muse Runt Ime Stet 
Slee Siet anes Seed sae Guns Goce Gast Sows cont Suns Sue Sang S008 Sune Oren Sune Seow wile Sows Gres cand Sine Sens ew Oe OS Ste emee wae poen vane sope Seve pend Seen spas eats suet sone mney URE mnt Sent 


doer sone wee eee aes apne cunt eee cone vate sent enwe anes meee amen SO08 out 
fone sont Stee sone ove are} song stn nese soon sows shee oye wore Sra Simm sine ooee seme emee cece enee 
Sams Bios Sane Soee Seen oeoe oes SS a oe oe SSS SSS Sage Sass ee SEO Sas, Ses Seat: Seer pene Sues cune ‘pees. sees ees sais. 


bow + @ ww A 
> 
th 
hh 
D> 
o 
qn 
Po 


“Ae 
bd 
“Nw 
th 
‘TY 
o 
Hh 
“NI 


cot cree wane pane ute inte nine mike Dent une aie eune saet geen moms snes maw 
SSSS SS Sass Saas See SEES Onee cts Clee tame seme enews meee Sune canny seen Gane SeeQhtes Ree Reeeceth recht credreenEere Base herr Ber Keree eek ee kee 


gece came eens ware eugg sone Sane Sen Mein Simro snwe owns mnew SOR OOOS seed conn 
Geet See Sots Sete Sete SoS OS SSS SESE SSS Se aoe Ss Saas Saas See Sees ‘sees awe wow pune secs Gime ween aus saee Bons pune cows wees seed ened wane Sued ante 
Be Stee Sine ents Sane Sete odes See Spee Seis Se Sms Sone ote oeee mene suns sone 


63 SF 077 DEL 127 7F 177 Delete 


nuee amas woes seen med Seen vane seat Hany mime Gate somy Rom GuiE mie Sone ene wee 
SSS FESS SSS SSee SSeS evel Sept Sees ont Geet som isemt Sone ont cane seme teow goss come rene mee woes sews sets bese pees Sima tiny Suet ney Dita suee cine — fod 
: snen quay mney seve tye cose nosy tees neon sony sere 


APPENDIX B 
A 64K Memory Map 


The 8080 and Z-80 microprocessors can directly address 64K bytes of 
memory. The memory area is mapped out in the chart that follows. Each entry 
represents a 256-byte block. The high-order byte of the address is given in hex 
then in octal. For example, the first entry of the second column is: 


20 040 $2 


This represents an address range of 2000 to 2FFF hex, or 040-000 to 040- 
777 octal. The third column gives the decimal number of 1K blocks. The fourth 
column is the decimal number of 256-byte blocks starting at the address 100 
hex. As an example, suppose that a CP/M program runs from 100 hex to 3035 
hex. The 30 hex entry in the table shows that the program contains 48 decimal 
blocks of 256-byte size. The program can be saved with the CP/M command: 


A=SAVE 48 filename 


As another example, if you have two, 16K memory boards starting at 
address zero, then your top of memory is located at address 7FFF hex. 
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Hex Oct K Bl Hex Oct K Bl Hex Oct K Bl Hex Oct KR 


20ST SROs Sete eee Sere oees feet sect ees sees ese case sess sees coer meee cere sore rete rest ener aces gree spte saet eres cose see een cous snes coe ete suse save natn come nny mune cose sane nee shen ovet nate fine Sena “ant Sent wtD neat Sent BOS beve SubE tune want Sune seme eoet 
Seas Seu Gene Seen Sant ont seus Hiee San Same coer Sass Goes OuyT Gone Stas One OOSE GOFe PORE DEUS BMMG fue Span neue Sane Sore Some SEZ came Suet Sues sous Sune nie Sent Sane Seat Sere Sunt See teee Gate Sent Guce Geen coem sees Gabe Some Seah See SOUS Nene ene Gemm teee Sant 


00 000 0 20 040 32 40 100 64 60 140 96 
O1 O01 1 21 041 33 41 101 65 61 141 97 
02 002 2 22 042 34 42 102 66 62 142 98 
03 003 1 3 23 043 9 35 43.103 17 67 63 143 25 99 
ate RSS Sate Sie Seas tea SSR SIRS SES NGS ES GSTS Sas SSS SE Se Soak SES Sees Sees Sees Soe Sees Sees SOG See stad Some Shee Site ats see Goce Soo sets cms ster sete eee sees cscs ete se os sce see ott sees sees see seer eet te oes et er ee er ee 


S225 SSA Ged Se See SAT SOoE OTE GES Stes Sees sett sete eos coat sees sere coer seve cess ses cove emer cee cone see suse soos eile ene spe soe core sare aeee seen seen cons cone Hens ste Sent ante SEO Suet Nene heme GuRe sthe nhbe come Anes que sere orm wets Grae soey come 
eee Tene Stee come See Sums MNS HERE RAGE StmY Sabu SOLE ane Sle Gen dene Sere Seen unt ont Sond GuED Sunt Smee Sone Soe res tome SEIS Gane Rect Goad boee Suue hae Sond Heat See Sore WOOD Same MINS Suet SOGY Sie mot SOG name Sane cote Sent Sete Suet Sco Site SDT SUMS Stee come 


oS 
bs a 
S 
ary 
bl fh 
Ol 


Se as Same See a SSE ee es i a Sa ae en ss Se sc sn se an cn Sc oa ca oe ms ce ee Sn es st eve cn eat oe hc oc oe oe oa oe ee oo oe oe ee 
10 020 16 30 060 48 90 120 80 70 160 1i2 
11 021 17 31 061 49 si 121 81 71 161 113 


SSS SSS Seas Say Sees Sees Sees Sete See coe ete coat cree es sree sees sees Sere cere cess cree eet moet meee mate tare cory seve edhe came evan sone egme supe sane sess onan sees pane stem muse seve save ofle cena ween some Goeq sree Neve Catt vine euet mut sullb sett sues tuey cout 
oan bine See cue Sene Hoon SeuT Same Rebe San Seen sane heme Ee Sree pune Rose Bow Soew Gums meee con Lane cous om Sind SOUS Suet SAIC Coed tote Suue San Sper come onem Hea OGae Geer caus SOSO snes seen SGie coon Satt cone Soet scos Ske Sent Stes Saat Socr Sate sows gues meee suse 


‘S205 Som Sass SSSr See Sate eee seer cuee meee nets coeu sone ode eves emee ove wens ness sume seus nese Be0y sane Sete sues seve Hoos Ofe ees Sune nent Duet Sune ROLE RttT Gin Stte Hise sete bnte pee sen fhe SEND Site MIVIE ates Site Ohne HONe tine mee bose coer Bone pues foie Grey 


Smee ene coun Stee Sune OnE oute ine vOne Sen Sane UhEL Hen Fils Buen Ree Bret Webt Lote Onan Summ Goes Ginn tims GueG nate Goes Snin Odie sae Aone Doe Sock oObE ues cama Sams SuEe meee few Gnas kane cone S4pe Some Seat Same Goes Sete Seat Sine Stee Stee Meee soot sews secs sets soos 


eee poew cane noes Dove MOLe MERE Wnt Hone Lede ante supe SEE anon nace bane w9e come Hone Bane Geve Seln Sone HON) Seee ene FeND SHER, S7A Sune se0e eve Bree Dene ateY HONE SUR CONT evEE cunS Swen Lome Sore foes woe fone neve euee Dem Suet tent bees Sees want tone meee mvEe 
cone tone GOR ame cate Senn Hine Nie Soot Diet onee SKE Get enee Sete Fin cue Sure Site Sore Sone Sune Dcup Seba Dem Own come Guat seat Sit Saw Hone Sous cue Suet Seat FOSS Saat Gees Sane Smt SRO SEO S00 Dpwe Some Meee Sore Sone Soe seas cme Se Stat St Stet sors sete sce coor sis 
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Hex Oct K Rl Hex Oct K Bl Hex Oct K Bl Hex Oct K- Bl 


80 200 128 AQ 240 160 CO 300 192 EO 340 224 

81 201 129 Al 241 161 Ci 301 193 E1 341 225 

82 202 130 A2 242 162 C2 302 194 E2 342 226 

83 203 33 131 AS 243 41 163 C3 303 49 195 E3 343 S37 227 
SS SS ES SS Ss SS Sees hs Sess See fee Sa Saas a Sa eg Sas Seah ets Saas Same Soe ae So Se Sa a oe Sc cesses ce se oe ke et ot ee mo ee oe oe ce 


SMAI SoM KI Ie Me aI KS ee eae SM AKAM seats eam sms a bas mss mmm esses 
88 210 136 AB 250 168 Cs 310 200 E& 350 232 
89 211 137 AY 251 169 cy 331i 201 E? i351 233 


Sore nome wee sone sone same yuan cuss smn song sem anes reine sone save SYN stim mene Sone Sued come Seed shi SHEE outs Sein Ge sont arte eves site afin smg Suen orty mom pove Howe mule MOG? fet Hvad rns BOCG ooiy mee Sint ffs SueN ttre Done sim wed Guns pote Saat sue putt Site rein ene Sone oie 
SSSS SERS Sens Sass SOaS Sees Stee Seed Sane SNS cent some Sone sone tune Os cusp nose cons Suse coms oees sane act Guat Goo Som Sues moet Some coon a@ee samt Snes cunt supp Sct sous sur saut Samp Suse Sen Sunt some sane Sear Sif soee aves Sous mona sven nous nave Some send con sont ceot sant coon sme 


P4 224 148 B4 264 180 D4 324 212 F4 364 244 
9S 225 149 BS 265 181 DS 325 213 FS 345 245 


ER See SS SS Se Ss Sees Sa Ss Sa See ae ae SS Ss Ses Sos SS See See Sas Sack tae Sie Sie Sieg Sis Sas Se See Secs Sie Shes Sat Seg Ss Ss oe ee es SS Ss Se i ee Se a on Ss a 
98 230 152 BS 270 184 N8 330 216 F8 370 248 
99 231 153 BY 271 185 nY 331 217 F9 371 249 


S222 Some meme came poem cay even cue omen vc mewn aise seve wean pune SU meee cuied sone sume sean sgh oun ften ouen mim OOER 208 fund seen ene athe Seve One Suh ED SEED HEMR TuEt MOD MWe SUH Soe ume ite sete tus fhe cute oisn Uni cube comb Gust fue cmt see apne one Start mens won om 
ret eet seme mene Suan cue nme Seve Gow Seed BOT SnuD Seen Gunn swe adie Gane cue Sens AOW Sune cnet Cane nme Sune Ga Seer Stat nowt Suny Soon GES ape cunt See Sten Sons sous SOO onus Sens One SUD Sous Guar Comm Scat athe aren came ned ceo saat Suet Gowe Sues news anet seut nen Seon Sees seen 


fine goum cove cons sume enmy cane wane muse sum name com aves sous sume siby mum owpe oath cues sunt nom wine veut Seam etlin suow cues Hime wows wenn Aine ouie van Wine eube Sum Dime send Chet Sots cout mat Sepw fit mins Hetty sSby wht Woy tet Meee Eoee OxNG Ste used evoT snus penn sit tue Dome wont 
wes Se Sone Smee Suu Sol Gees Sees Saat ined Sear sua Lend wate wows cane awe fuer Sunt Cale Dams GEES GUOR OLD VRP SOUS SEND Cut Cows Comm BYES Siw Give nb Sent Some Goes GmiM Oene Guay oes cote Seed Seen Mae SOeE Sune Rete: See Sand One Sow inet sven ‘ny Sens Sure Man deed SERS mowe SuuE cone Guan SHS 


APPENDIX C 


The 8080 Instruction Set 
(Alphabetic) 


The 8080 instruction set is listed alphabetically with the corresponding 
hexadecimal code. The following representations apply. 

nn 8-bit argument 

nnnn 16-bit argument 


Hex Mnemonic Hex Mnemonic 
CE nn ACI nn 2F CMA 
8F ADC A 3F CMC 
88 ADC B BF CMP A 
89 ADC C B8 CMP B 
8A ADC D BQ CMP C 
8B ADC E BA CMP D 
8C ADC H BB CMP E 
8D ADC L BC CMP H 
8E ADC M BD CMP L 
87 ADD A BE CMP M 
80 ADD B D4 = nnnn CNC nnnn 
81 ADD C C4 nnnn CNZ nnnn 
82 ADD D F4  nnnn CP nnnn 
83 ADD E EC nnnn CPE nnnn 
84 ADD H FE nn CPI nn 
85 ADD L E4 = nnnn CPO _nnnn 
86 ADD M CC nnnn CZ nnnn 
C6 nn ADI nn 27 DAA 
Al ANA A 09 DAD B 
AO ANA B 19 DAD D 
Al ANA C 29 DAD H 
A2 ANA D 39 DAD SP 
A3 ANA E 3D DCR A 
A4 ANA H 05 DCR B 
AD5 ANA L OD DCR C 
A6 ANA M 15 DCR D 
E6 nn ANI nn 1D DCR E 
CD nnnn CALL nnnn 25 DCR H 
DC nnnn CC nnnn 2D DCR L 
FC nnnn CM nnnn 35 DCR M 
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Hex 


nn 


nnnn 
hnnnn 
nnnn 
nnnn 
nnnn 
nnnn 
nnnn 
nnnn 
nnnn 
nnnan 


nnnn 
nnonn 
nnnn 
nnnn 
nnnn 


Mnemonic 
DCX B 
DCX D 
DCX H 
DCX SP 
DI 
EI 
HLT 
IN nn 
INR A 
INR B 
INR C 
INR D 
INR E 
INR H 
INR L 
INR M 
INX B 
INX D 
INX H 
INX SP 
JIC nnnn 
JM nnnn 
JMP  nnnn 
JNC  nnnn 
JNZ  nnnn 
JP nnnn 
JPE  nnnn 
JPO  nnnn 
JZ nnnn 
LDA  nnnn 
LDAX B 
LDAX D 
LHLD nnnn 
LXI B, nnnn 
LXI D,nnnn 
LXI H,nnnn 
LXI SP, nnnn 
MOV A,A 
MOV A,B 
MOV A,C 
MOV A,D 
MOV A,E 
MOV A,H 
MOV A,L 
MOV A,M 
MOV B,A 
MOV B,B 
MOV B,C 
MOV B,D 
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Hex Mnemonic Hex Mnemonic 
74 : MOV MH CF RST 1 
715 MOV M,L D7 RST 2 
38E nn MVI A,nn DF RST 3 
06 nn MVI- B,nn E7 RST 4 
OE nn MVI C,nn EF RST 5 
16 nn. MVI D,nn F7 RST 6 
1E nn MVI_ E,nn FF RST 7 
26 nn MVI H,nn C8 RZ 
2E nn | MVI- L,nn OF SBB A 
36 nn MVI M,nn 98 SBB B 
00 NOP 99 SBB C 
B7 ORA A 9A SBB D 
BO ORA B 9B SBB E 
Bl ORA C 9C SBB H 
B2 ORA D 9D SSBB L 
B3 ORA E 9E SBB M 
B4 ORA H DE nn SBI nn 
Bd ORA L 22 nnnn SHLD nnnn 
B6 ORA M F9 SPHL 
F6 nn ORI nn 32 nnnn STA nnnn 
D3 nn OUT hn 37 STC 
E9 PCHL 02 STAX B 
C1 POP B 12 STAX D 
D1 POP D 97 SUB A 
El « POP H 90 SUB B 
F1 POP PSW 91 SUB C 
C5 PUSH B 92 SUB D 
D5 PUSH D 93 SUB E 
E5 PUSH H 94 SUB H 
F5 PUSH PSW 95 SUB L 
17 RAL 96 SUB M 
iF RAR D6 nn SUI nn 
D8 RC EB XCHG 
C9 RET AF XRA A 
07 RLC A8 XRA B 
F8 RM AY XRA C 
DO RNC AA XRA D 
Co RNZ AB XRA E 
FO RP AC XRA H 
E8 RPE AD XRA L 
EO RPO AE XRA M 
OF RRC EE non XRI- nn 
C7 RST 0 E3 XTHL 
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The 8080 Instruction Set 
(Numeric) 


The 8080 instruction set is listed alphabetically with the corresponding 
hexadecimal code. The following representations apply. 


nn 8-bit argument 
nnnn 16-bit argument 


Hex Mnemonic Hex Mnemonic 
00 NOP 1E nn MVI E,nn 
01 nnnn LXI B, nnnn 1F RAR 
02 STAX B 20 (not used) 
03 INX B 21 ° nnnn LXI 4H, nnnn 
04 INR B 22  nnnn SHLD nnnn 
05 DCR B 23 INX H 
06 nn MVI- B,nn 24 INR H 
07 ' RLC 20 DCR H 
08 (not used) 26 nn MVI H,nn 
09 DAD B 27 DAA 
OA LDAX B 28 (not used) 
OB DCX B 29 DAD H |. 
OC INR C 2A nnnn LHLD nnnn 
OD DCR C 2B DCX H 
OE nn MVI C,nn 2C INR L 
OF RRC 2D DCR L 
10 (not used) 2E nn MVI- L,nn 
11 = =nnnn LXI D,nnnn 2F CMA 
12 STAX D 30 (not used) 
13 INX D 31 nnnn LXI SP, nnnn 
14 INR. D 32 nnnn STA  nnnn 
15 DCR D 33 INX SP 
16 nn MVI D,nn 34 INR M 
17 RAL 35 DCR M 
18 (not used) 36 nn MVI M,nn 
19 DAD D 37 STC 
1A LDAX D 38 (not used) 
1B DCX D 39 DAD SP 
1C INR E 3A  nnnn LDA  nnnn 
1D DCR E 3B DCX SP 


i 
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Hex Mnemonic Hex Mnemonic 
3C INR A 6D MOV L,L 
3D DCR A 6E MOV L,M 
8E nn MVI A,nn 6F MOV L,A 
3F CMC 70 MOV M,B 
40 MOV B,B 71 MOV M,C 
Al MOV B,C 72 MOV M,D 
42 MOV B,D 73 MOV M,E 
43 MOV B,E 74 MOV M,H 
44 MOV BH 75 MOV M,L 
45 MOV B,L 76 HLT 
46 MOV BM 77 MOV M,A 
47 MOV B,A 78 MOV A,B 
48 MOV C,B 79 MOV A,C 
49 MOV C,C 7A MOV A,D 
4A MOV C,D 7B MOV A,E 
4B MOV C,E 7C MOV A,H 
4C MOV C,H 7D MOV A,L 
4D MOV C,L TE MOV A,M 
4E MOV C,M 7F MOV A,A 
4F MOV C,A 80 ADD B 
50 MOV D,B 81 ADD C 
51 MOV. D,C 82 ADD D 
52 MOV D,D 83 ADD E 
53 MOV D,E 84 ADD H 
54 MOV D,H 85 ADD L 
55 MOV D,L 86 ADD M 
56 MOV DM 87 ADD A 
57 MOV D,A 88 ADC B 
58 MOV E,B 89 ADC C 
59 MOV. E,C 8A ADC D 
5A MOV E,D 8B ADC E 
5B MOV E,E 8C ADC H 
5C MOV E,H 8D ADC L 
5D MOV E,L 8E ADC M 
5E MOV EM 8F ADC A 
5F MOV E,A 90 SUB B 
60 MOV H,B 91 SUB C 
61 MOV H,C 92 SUB D 
62 MOV H,D 93 SUB E 
63 MOV H,E 94 SUB H 
64 MOV H,H 95 SUB L 
65 MOV H,L 96 SUB M 
66 MOV H,M 97 SUB A 
67 MOV H,A 98 SSBB B 
68 MOV L,B 99 SBB C 
69 MOV L,C 9A SBB D 
6A MOV L,D 9B SSBB E 
6B MOV L,E 9C SBB H 
6C MOV L,H 9D SBB L 
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Hex Mnemonic Hex Mnemonic 
9E SBB M CF RST 1 
9F SBB A DO RNC 
AO ANA B D1 POP D 
Al ANA C D2 nnnn JNC  nnnn 
A2 ANA D D3 nn OUT nn 
A383 ANA E D4 ss nnnn CNC nnnn 
A4 ANA H D5 PUSH D 
A5 ANA L D6 non SUI nn 
A6 ANA M D7 RST 2 
A7 ANA A D8 RC 
A8 XRA B Dg (not used) 
AQ XRA C DA nnnn JIC nnnn' 
AA XRA D DB nn IN nn 
AB XRA E DC nnnn CC nnnn 
AC XRA H DD — (not used) 
AD XRA L DE nn SBI non 
AE XRA M DF RST 3 
AF XRA A EO RPO 
BO ORA B El POP H 
Bl ORA C E2  nnnn JPO  nnnn 
B2 ORA D E3 XTHL 
B3 ORA E E4 nnnn CPO _nnnn 
B4 ORA H E5 PUSH H 
Bd ORA L E6 = nn ANI nn 
B6 ORA M E7 RST 4 
B7 ORA A E8 RPE 
B8 CMP B E9 PCHL 
B9 CMP C EA nnnn JPE  nnnn 
BA CMP D EB ; XCHG 
BB CMP E EC nnnn CPE nnnn 
BC CMP H ED (not used) 
BD CMP L EE nn XRI- nn 
BE CMP M EF RST 5 
BF CMP A FO RP 
CO RNZ F1 POP PSW 
C1 POP B F2  nnnn JP nnnn 
C2 = nnnn JNZ nnnn F3 DI 
C3 nnnn JMP  nnnn F4 nnnn CP nnnn 
C4 nnnn CNZ nnnn F5 PUSH PSW 
C5 PUSH B F6 nn ORI nn 
C6 nn ADI nn F7 RST 6 
C7 RST 0 F8 RM 
C8 RZ F9 SPHL 
C9 RET FA nnnn JM nnnn 
CA nnnn IZ nnnn FB EI 
CB (not used) FC nnnn CM = nnnn 
CC nnnn CZ nnnn FD (not used) 
CD nnnn CALL nnnn FE nn CPI nn 


CE nn ACI nn FF RST 7 


APPENDIX E 


The Z-80 Instruction Set 
(Alphabetic) 


The Zilog Z-80 instruction set is listed alphabetically with the corresponding 
hexadecimal values. The following representations apply. 


nn 8-bit arguments 
nnonn 16-bit arguments 
dd 8-bit signed displacement 


* instructions common to the 8080 

Hex Mnemonic Hex Mnemonic 
8E * ADC  A,(HL) 19 * ADD HL,DE 
DD 8Edd ADC A,(IX+dd) 29 * ADD £HL,HL 
FD 8Edd ADC A,(1Y+dd) 39 * ADD  HL,SP 
8F * ADC AJA DD 09 ADD _ IX,BC 
88 * ADC A,B DD 19 ADD  IX,DE 
89 * ADC A,C DD 29 ADD  IX,IX 
8A * ADC A,D DD 39 ADD _ IX,SP 
8B * ADC A,E FD 09 ADD _ IY,BC 
8C * ADC A,H FD 19 ADD _ IY,DE 
8D * ADC  A,L FD 29 ADD _ IY,IY 
CE nn * ADC A,nn FD 39 ADD _ IY,SP 
ED 4A ADC  HL,BC A6 * AND (HL) 
ED 5A ADC HL,DE DD A6dd AND _ (IX+dd) 
ED 6A ADC  HL,HL FD A6dd AND. (IY+dd) 
ED 7A ADC HL,SP AT / #* AND A 
86 * ADD  A,(HL) AO * AND B 
DD 86dd ADD A,(IX+dd) Al * AND C 
FD 86dd ADD A,TY+dd) A2 * AND OD 
87 * ADD A,A A3 * AND E 
80 * ADD A,B A4 * AND 4H 
81 * ADD  A,C Ad * AND  L 
82 * ADD  A,D E6 nn * AND nn 
83 * ADD  A,E CB 46 BIT 0,(HL) 
84 * ADD  A,H DD CBdd46 BIT 0,([X+dd) 
85 * ADD A,L FD CBdd46 BIT 0,([Y+dd) 
C6 nn * ADD  A,nn CB 47 BIT 0,A 
09 * ADD  HL,BC CB 40 BIT O,B 
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Hex Mnemonic Hex Mnemonic 
CB 41 BIT 0,C CB 68 BIT 5,B 
CB 42 BIT 0,D CB 69 BIT 5,C 
CB 43 BIT 0,E CB 6A BIT 5,D 
CB 44 BIT 0,H CB 6B BIT 5,E 
CB 45 BIT 0,L CB 6C BIT 5,H 
CB 4E BIT 1,(HL) CB 6D BIT 5,L 
DD CBdd4E BIT 1,(1X+dd) CB 76 | BIT 6,(HL) 
FD CBdd4E BIT 1,1Y+dd) DD CBdd76 BIT 6,([X+dd) 
CB 4F BIT 1A FD CBdd76 BIT 6,([Y+dd) 
CB 48 BIT 1,B CB 77 BIT 6,A 
CB 49 BIT 1,C CB 70 BIT 6,B / 
CB 4A BIT 1,D CB 71 BIT 6,C 
CB 4B BIT 1,E CB 72 BIT 6,D 
CB 4C BIT 1,H CB 73 BIT 6,E 
CB 4D BIT 1,L CB 74 BIT 6,H 
CB 56 BIT 2,(HL) CB 75 BIT 6,L 
DD CBdd56 BIT 2,([X+dd) CB 7E BIT 7,(HL) 
FD CBdd56 BIT 2,(T¥+dd) DD CBdd7E BIT 7,(1X+dd) 
CB 57 BIT 2,A FD CBdd7E BIT 7,(1Y+dd) 
CB 50 BIT 2,B CB 7F BIT 7,A 
CB 51 BIT 2:0 CB 78 BIT 7,B 
CB 52 BIT 2,D CB 79 BIT 7,C 
CB 53 BIT 2,E CB 7A BIT 7,D 
CB 54 BIT 2,H CB 7B BIT 7,E 
CB 55 BIT. 2,L CB 7C BIT 7,H 
CB 5E BIT 3,(HL) CB 7D BIT 7,L 
DD CBdd5E BIT 3,([X+dd) DC nnnn * CALL C,nnnn 
FD CBdd5E BIT 3,(1Y¥+dd) FC nnnn * CALL M,nnnn 
CB 5F BIT 3,A D4 nnnn * CALL NC,nnnn 
CB 58 BIT 3,B CD nnnn * CALL nnnn 
CB 59 BIT 3,C C4 nnnn * CALL NZ, nnnn 
CB 5A BIT 3,D F4 nnnn * CALL P,nnnn 
CB 5B BIT 3,E EC nnnn * CALL PE, nnnn 
CB 5C BIT 3,H E4 nnnn * CALL PO,nnnn 
CB 5D BIT 3,L CC nnnn * CALL Z,nnnn 
CB 66 BIT 4,(HL) 3F * CCF 
DD CBdd66 BIT 4,(IX+dd) BE * CP (HL) 
FD CBdd66 BIT 4,(1¥+dd) DD BEdd CP (IX+dd) 
CB 67 BIT 4,A FD BEdd CP (TY +dd) 
CB 60 BIT 4.B BF * CP A 
CB 61 BIT 4.C B8 * CP B 
CB 62 BIT 4,D B9 CP C 
CB 63 BIT 4,E BA CP D 
CB 64 BIT 4,H BB OCP E 
CB 65 BIT 4,L BC * CP H 
CB 6E BIT 5,(HL) BD * CP L 
DD CBdd6E BIT 5,([X+dd) FE nn * CP nn 
FD CBdd6E BIT 5,(1Y+dd) ED AQ CPD 
CB 6F BIT 5,A ED B9 
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2B 
2B 


dd 


E3 


* %¥ & & Ke % F 


* 


* *¥ * * * 


Mnemonic 
CPI 
CPIR 
CPL 
DAA 
DEC (HL) 
DEC (IX+dd) 
DEC (IY+dd) 
DEC A 
DEC B 
DEC BC 
DEC C 
DEC D 
DEC DE 
DEC E 
DEC H 
DEC HL 
DEC IX 
DEC IY 
DEC L 
DEC SP 
DI 
DJNZ dd 
EI 
EX (SP) HL 
EX (SP),IX 
EX (SP) IY 
EX AF,AF' 
EX DE,HL 
EXX 
HALT 
IM 0 
IM 5 
IM 2 
IN A,(C) 
IN A,(nn) 
IN B,(C) 
IN C,(C) 
IN D,(C) 
IN E,(C) 
IN H,(C) 
IN L,(C) 
INC (HL) 
INC (IX+dd) 
INC (I¥+dd) 
INC A 
INC B 
INC BC 
INC C 
INC D 


Hex Mnemonic 
13 * INC DE 
1c * INC E 
24 * INC H 
20 * INC HL 
DD 23 INC IX 
FD 23 INC IY 
2C * INC L 
33 * INC SP 
ED AA IND 
ED BA INDR 
ED A2 INI 
ED B2 INIR 
E9 * JP (HL) 
DD E9 JP (TX) 
FD EQ JP (TY) 
DA nnnn * JP C, nnnn 
FA nnnn © IP M, nnnn 
D2 nnnn * JP NC, nnnn 
C3 nnnn * JP nnnn 
C2 nnnn * JP NZ, nnnn 
F2 nnnn * JP P, nnnn 
EA nnnn * JP PE, nnnn 
E2 nnnn * JP PO, nnnn 
CA nnnn * JP Z, nnnn 
38 dd JR C, dd 
18 dd JR dd 
30 dd JR NC, dd 
20 dd JR NZ, dd 
28 dd - JR Z, dd 
02 * LD (BC),A 
12 * LD (DE),A 
77 * LD (HL),A 
70 * LD (HL),B 
71 * LD (HL),C 
72 * LD (HL),D 
73 * LD (HL),E 
74 * LD (HL),H 
75 * LD (HL),L 
36 nn * LD (HL), nn 
DD 77dd LD (IX+dd),A 
DD 70dd LD (IX+dd),B 
DD 71dd LD (IX+dd),C 
DD 72dd LD (IX+dd),D 
DD 73dd LD (IX+dd),E 
DD 74dd LD (IX+dd),H 
DD 75dd LD (IX+dd),L 
DD 36ddnn LD (IX+dd), nn 
FD 77dd LD (T¥+dd),A 
FD 70dd LD (TY+dd),B 


Hex 


T1dd 
72dd 
73dd 
74dd 
75dd 
36ddnn 
nnnn 
43nnnn 
53nnnn 
nnnn 
22nnnn 
22nnnn 
73nnnn 


7Edd 
7Edd 
nnnn 


nn 
4Bnnnn 
nnnn 


4kdd 
4Edd 


x * *¥ *¥ & * * 


x & & 


* Xe 4 He ee * 


Mnemonic 


(TY+dd),C 
(1Y¥+dd),D 
(1Y¥+dd),E 
(T¥+dd),H 
(1Y+dd),L 
(TY+dd), nn 
(nnnn),A 
(nnnn),BC 
(nnnn),DE 
(nnnn),HL 
(nnnn),IX 
(nnnn), TY 
(nnnn),SP 
A,(BC) 
A,(DE) 
A,(HL) 
A,(IX+dd) 
A,TY+dd) 
A, (nnnn) 
A,A 


B(IX+dd) 


BA 


B, nn 

BC, (nnnn) 
BC, nnnn 
C,(HL) 
C,(1X+dd) 
C,(TY+dd) 
C,A 

C,B 

C.C 

C,D 


d6dd 
56dd 


nn 
5Bnnnn 
nnnn 


dEdd 
dEdd 


nn 


66dd 
66dd 


2Annnn 


* * ¥ %¥ % ® He F 


* * *¥ %¥ *# %¥ *¥ * 


* ¥ %¥ & ¥ He He He Ke 
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Mnemonic 


D,(IX+dd) 


DA 


DE, (nnnn) 
DE, nnnn 
E,(HL) 
E,(1X+dd) 
E,(1Y+dd) 
BA 


H,(IX+dd) 


ILA 


HL, (nnnn) 
HL, nnnn 
IA 

IX, (nnnn) 
IX, nnnn 
IY, (nnnn) 
IY, nnnn 
L,(HL), 
L,([X+dd) 
L,(TY¥+dd) 


268 8080/Z-80 ASSEMBLY LANGUAGE 
Hex Mnemonic Hex Mnemonic 
6F * LD L,A F5 * PUSH AF 
‘68 * LD L,B C5 * PUSH BC 
69 * LD L,C D5 * PUSH DE 
6A * LD L,D E5 * PUSH HL 
6B * LD L,E DD E5 PUSH IX 
6C * LD L,H FD E5 PUSH IY 
6D * LD L,L CB 86 RES 0,(HL) 
2E nn * LD L, nn DD CBdd86 RES 0,([1X+dd) 
ED 4F LD R,A FD CBdd86 RES 0,(1Y+dd) 
* ED 7Bnnnn LD | SP, (nnnn) CB 87 RES 0,A 
F9 * LD SP,HL CB 80 RES 0,B 
DD F9 LD SP,IX CB 81 RES 0,C 
FD F9 LD SP, IY CB 82 RES 0,D 
~31 > nnnn * LD SP, nnnn CB 83 RES 0,E 
ED A8 LDD CB 84 RES 0,H 
ED B8 LDDR CB 85 RES 0,L 
ED AO LDI CB 8E RES 1,(HL) 
ED BO LDIR DD CBdd8E RES 1,(1X+dd) 
ED 44 NEG FD CBdd8E RES 1,1Y+dd) 
00 * NOP CB 8F RES 1,A 
BE * OR (HL) CB 88 RES 1,B 
DD Bédd OR (IX+dd) CB 89 RES 1,C 
FD B6édd OR (TY+dd) CB 8A RES 1,D 
B7 * OR A CB 8B RES 1,E 
BO * OR B CB 8C RES 1,H 
Bl * OR C CB 8D RES 1,L 
B2 * OR D CB 96 RES 2,(HL) 
B3 * OR E DD CBdd96 RES 2,(IX+dd) 
B4 * OR H FD CBdd96 RES 2,(1Y+dd) 
B5 * OR L CB 97 RES 2,A 
F6 nn * OR nn CB 90 RES 2,B 
ED BB OTDR CB 91 RES 2,C 
ED B3 OTIR CB 92 RES 2,D 
ED 79 OUT (C),A CB 93 RES 2,E 
ED 41 OUT = (C),B CB 94 RES 2H 
ED 49 OUT = _(C),C CB 95 RES 2,L 
ED 51 OUT (C),D CB 9E RES 3,(HL) 
ED 59 OUT  (C),E DD CBdd9E RES 3,(IX+dd) 
ED 61 OUT (C),H FD CBdd9E RES 3,(TY+dd) 
ED 69 OUT (C),L CB 9F RES 3,A 
D3 nn * OUT  (nn),A CB 98 RES 3,B 
ED AB OUTD CB 99 RES 3,C 
ED A3 OUTI CB 9A RES 3,D 
Fl * POP AF CB 9B RES 3,E 
C1 * POP BC CB 9C RES 3,H 
D1 * POP DE CB 9D RES 33a 
El * POP HL CB A6 RES 4,(HL) 
DD E1 POP IX DD CBddA6 RES 4,(1X+dd) 
FD El POP IY FD CBddA6 RES 4,(1Y+dd) 
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FD CBddAE 


ee %¥ e % %F He 


Mnemonic 
RES 4,A 
RES 4,B 
RES 4,C 
RES 4,D 
RES 4,E 
RES 4,H 
RES 4,L 
RES 5,(HL) 
RES 5,([X+dd) 
RES 5,(TY+dd) 
RES 5,A 
RES 5,B 
RES 5,C 
RES 5,D 
RES 5,E 
RES 5,H 
RES 5,L 
RES 6,(HL) 
RES 6,([X+dd) 
RES 6,(IY+dd) 
RES 6,A 
RES 6,B 
RES 6,C 
RES 6,D 
RES 6,E 
RES 6,H 
RES 6,L 
RES 7,(HL) 
RES 7,(1X+dd) 
RES 7,(1Y+dd) 
RES 7,A 
RES 7,B 
RES 7,C 
RES 7,D 
RES 7,E 
RES 7.H 
RES 7,L 
RET 
RET C 
RET M 
RET NC 
RET NZ 
RET P 
RET PE 
RET PO 
RET Z 
RETI 
RETN 
RL (HL) 


DD 
FD 


CBddi6 


06 


CBdd06 


CBdd1E 


OE 
CBdd0E 


Mnemonic 
RL (IX+dd) 
RL (T¥+dd) 
RL A 
RL B 
RL C 
RL D 
RL E 
RL H 
RL L 
RLA 
RLC (HL) 
RLC (IX+dd) 
RLC (TY+dd) 
RLC A 
RLC B 
RLC C 
RLC D 
RLC E 
RLC H 
RLC L 
RLCA 
RLD 
RR (HL) 
RR (IX+dd) 
RR (TY+dd) 
RR A 
RR B 
RR C 
RR D 
RR E 
RR H 
RR L 
RRA Se 
RRC (HL) 
RRC (IX+dd) 
RRC (IY+dd) 
RRC A 
RRC B 
RRC C 
RRC D 
RRC E 
RRC 4H 
RRC L 
RRCA 
RRD 
RST 0 
RST 8 
RST 10H 
RST 18H 
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CB 


C6 


CBddCE 


* 


Mnemonic 

RST 20H 
RST 28H 
RST 30H 
RST. 38H 

SBC A,(HL) 
SBC A,(1X+dd) 
SBC A,(TY+dd) 
SBC A,A 
SBC A,B 
SBC A,C 
SBC A,D 
SBC A,E 
SBC A,H 
SBC A,L 
SBC A, nn 
SBC HL,BC 
SBC HL,DE 
SBC HL,HL 
SBC HL,SP 
SCF 
SET 0,(HL) 
SET 0,(IX+dd) 
SET 0,([Y+dd) 
SET 0,A 
SET 0,B 
SET 0,C 
SET 0,D 
SET 0,E 
SET 0,H 
SET 0,L 
SET 1,(HL) 
SET 1,({X+dd) 
SET 1,7Y+dd) 
SET 1,A 
SET 1,B 
SET 1,C 
SET 1,D 
SET 1,E 
SET 1,H 
SET 1,L 
SET 2,(HL) 
SET 2,(1X+dd) 
SET 2,(1Y+dd) 
SET 2,A 
SET 2,B 
SET 2,C 
SET 2,D 
SET 2,E 
SET 2,H 


Mnemonic 


FD CBddEE 


3,(IY+dd) 
3,A 
3B 


5 (IX+dd) 
5 (1Y-+dd 
5A 


6,(IX+dd) 


6,A 


7,(IX+dd) 
7,(1Y¥+dd) 
7A 


mee en ett tt 


DD CBdd26 


FD CBdd2E 


DD CBdd3E 
FD CBdd3E 
CB 3F 


Mnemonic 
SET 7,H 
SET 7,L 
SLA (HL) 
SLA (1X+dd) 
SLA (TY+dd) 
SLA A 
SLA B 
SLA C 
SLA D 
SLA E 
SLA H 
SLA L 
SRA (HL) 
SRA (IX+dd) 
SRA (1Y+dd) 
SRA A 
SRA B 
SRA C 
SRA D 
SRA E 
SRA H 
SRA L 
SRL (HL) 
SRL (IX+dd) 
SRL (1Y+dd) 
SRL A 
SRL B 
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Hex Mnemonic 
CB 39 SRL C 
CB 3A SRL D 
CB 3B SRL E 
CB 3C SRL H 
CB 3D SRL L 
96 * SUB (HL) 
DD 96dd SUB (IX+dd) 
FD 96dd SUB (1Y+dd) 
97 * SUB A 
90 * SUB B 
91 * SUB C 
92 * SUB D 
93 * SUB E 
94 * SUB H 
95 * SUB L 
D6 nn * SUB nn 
AE * XOR (HL) 
DD AEdd XOR = (IX+dd) 
FD AEdd XOR (IY+dd) 
AF * XOR A 
A8 * XOR  B 
AQ * XOR C 
AA * XOR OD 
AB * XOR E 
AC * XOR 4H 
AD * XOR  L 
EE nn * XOR nn 
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The Z-80 Instruction Set 
(Numeric) 


The Zilog Z-80 instruction set is listed numerically with the corresponding 
hexadecimal values. The following representations apply. 


Hex 


O1 nnnn 


06 nn 


OE nn 


10 dd 
11 nnnn 


16 nn 


18 dd 


* ¥ %& & *¥ %# % 


* ££ * & KF 


* + & 


¥ eee HK 


nn 8-bit argument 


nnnn 16-bit argument 


dd 8-bit signed displacement 


* instructions common to the 8080 

Mnemonic Hex Mnemonic 
NOP 1C * INC E 
LD BC, nnnn 1D * DEC &E 
LD (BC),A 1E nn * LD E, nn 
INC BC 1F * RRA 
INC B 20 dd JR NZ, dd 
DEC B 21 nnnn * LD HL, nnnn 
LD B, nn 22 nnnn * LD (nnnn),HL 
RLCA 23 * INC HL 
EX AF,AF' 24 * INC H 
ADD HL,BC 25 * DEC 4H 
LD A,(BC) 26 nn * LD H, nn 
DEC BC 27 * DAA 
INC Cc 28 dd JR Z, ad 
DEC C 29 *, ADD 4HL,HL 
LD C, nn 2A nnnn * LD HL, (nnnn) 
RRCA 2B * DEC HL 
DJNZ dd 2C * INC L 
LD DE, nnnn 2D * DEC L 
LD (DE),A 2E nn * LD L, nn 
INC DE 2F * CPL 
INC D 30 dd JR NC, dd 
DEC D 31 nnnn * LD SP, nnnn 
LD D,nn 32 nnnn * LD (nnnn),A 
RLA 33 * INC SP 
JR dd 34 * INC (HL) 
ADD  HL,DE 35 * DEC (HL) 
LD A,(DE) 36 nn * LD (HL), nn 
DEC DE 37 * SCF 


Hex Mnemonic 
38 dd JR C, dd 
39 * ADD  HL,SP 
3A nnnn * LD A, (nnnn) 
3B * DEC SP 
3C * INC A 
3D * DEC A 
3E nn * LD A,nn 
3F * CCF 
40 * LD B,B 
41 * LD B,C 
42 * LD B,D 
43 * LD B,E 
44 * LD B,H 
45 * LD B,L 
46 * LD B,(HL) 
47 * LD B,A 
48 * LD C.B 
49 * LD CC 
4A * LD C,D 
4B * LD C,E 
4C * LD C,H 
4D * LD C,L 
4E * LD C,(HL) 
4F * LD C,A 
50 * LD D,B 
51 * LD D,C 
52 * LD D,D 
53 * LD D,E 
54 * LD D,H 
55 * LD D,L 
56 * LD D,(HL) 
57 * LD D,A 
58 * LD E,B 
59 * LD E,C 
5A * LD E,D 
5B * LD E,E 
5C * LD E,H 
5D * LD E,L 
5E * LD E,(HL) 
5F * LD E,A 
60 * LD H,B 
61 * LD H,C 
62 * LD H,D 
63 * LD H,E 
64 * LD H,H 
65 * LD H,L 
66 * LD H,(HL) 
67 * LD H,A 
68 * LD L,B 
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Hex Mnemonic 
69 * LD L,C 
6A * LD L,D 
6B * LD L,E 
6C * LD L,H 
6D * LD L,L 
6E * LD L,(HL) 
6F * LD L,A 
70 * LD (HL),B 
71 * LD (HL),C 
72 * LD (HL),D 
73 * LD (HL),E 
74 * LD (HL),H 
715 * LD (HL),L 
76 * HALT 
77 * LD (HL),A 
78 * LD A,B 
79 * LD A,C 
7A * LD A,D 
7B * LD A,E 
7C * LD A,H 
7D — * LD A,L 
TE * LD A,(HL) 
7F * LD A,A 
80 * ADD A,B 
81 * ADD  A,C 
82 * ADD  A,D 
83 * ADD A,E 
84 * ADD AH 
85 * ADD AVL 
86 * ADD A,(HL) 
87 * ADD AJA 
88 * ADC A,B 
89 * ADC  A,C 
8A * ADC A,D 
8B * ADC AVE 
8C * ADC A,H 
8D * ADC AJL 
8E * ADC A,(HL) 
8F * ADC AJA 
90 * SUB B 
91 * SUB C 
92 * SUB D 
93 * SUB E 
94 * SUB H 
95 * SUB L 
96 * SUB (HL) 
97 * SUB A 
98 * SBC A,B 
99 * SBC A,C 
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Hex Mnemonic Hex Mnemonic 
9A * SBC A,D CB 00 RLC B. 
9B * SBC A,E CB O1 RLC C 
9C * SBC A,H CB 02 RLC D 
9D * SBC A,L CB 03 RLC E 
9E * SBC A,(HL) CB 04 RLC H 
OF . * SBC A,A CB 05 RLC L 
AO * AND B CB 06 RLC (HL) 
Al * AND C CB 07 RLC A 
A2 * AND OD CB 08 RRC B 
A3 * AND  E CB 09 RRC C 
A4 * AND 4H CB OA RRC D 
A5 * AND L CB OB RRC E 
A6 * AND (HL) CB OC RRC H 
AT * AND A CB OD RRC L 
A8 * XOR  B CB OE RRC (HL) 
AQ * XOR C CB OF RRC A 
AA * XOR OD CB 10 RL B 

AB * XOR . E CB 11 RL C 
AC * XOR 4H CB 12 RL D 
AD * XOR  L CB 13 RL E 
AE * XOR (HL) CB 14 RL H 
AF * XOR A CB 15 RL L 
BO * OR B CB 16 RL (HL) 
Bl * OR C CB 17 RL A 
B2 * OR D CB 18 RR B 
B3 * OR E CB 19 RR C 
B4: * OR H CB 1A RR D 
Bd * OR L CB 1B RR E 
B6 * OR (HL) CB 1C RR H 
B7 * OR A CB 1D RR L 
B8 * CP B CB 1E RR (HL) 
B9 *GP C CB 1F RR A 
BA * CP D CB 20 SLA B 
BB * OP E CB 21 SLA C 
BC * CP H CB 22 SLA D 
BD * CP L CB 23 SLA E 
BE * CP (HL) CB 24 SLA H 
BF * CP A CB 25 SLA L 
CO * RET NZ CB 26 SLA (HL) 
C1 * POP BC CB 27 SLA A 
C2 nnnn * JP NZ, nnnn CB 28 SRA B 
C3 nnnn * JP nnnn CB 29 SRA C 
C4 nnnn * CALL NZ, nnnn CB 2A SRA D 
C5 * PUSH BC CB 2B SRA E 
C6 nn * ADD A,nn CB 2C SRA H 
C7 * RST 0 CB 2D SRA L 
C8 * RET Z CB 2E SRA (HL) 
C9 * RET CB 2F SRA A 
CA nnnn * JP Z, nnnn CB 38 SRL B 
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Mnemonic 
SRL C 
SRL D 
SRL E 
SRL H 
SRL L 
SRL (HL) 
SRL A 
BIT 0,B 
BIT 0,C 
BIT 0,D 
BIT 0,E 
BIT 0,H 
BIT OL 
BIT 0,(HL) 
BIT A 
BIT 1,B 
BIT 1,C 
BIT 1,D 
BIT 1,E 
BIT 1,H 
BIT 1,L 
BIT 1,(HL) 
BIT 1,A 
BIT 2,B 
BIT 2,C 
BIT 2,D 
BIT 2, 
BIT 2,H 
BIT 2,L 
BIT 2,(HL) 
BIT 2,A 
BIT 3,B 
BIT 3,C 
BIT 3,D 
BIT 3,E 
BIT 3,H 
BIT 3,L 
BIT 3,(HL) 
BIT 3,A 
BIT 4,B 
BIT 4,C 
BIT 4,D 
BIT 4,E 
BIT 4,H 
BIT 4,L 
BIT 4,(HL) 
BIT 4,A 
BIT 5,B 
BIT 5,C 
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Hex Mnemonic Hex Mnemonic 
CB 9B RES 3,E CB CC SET 1,H 
CB 9C RES 3,H CB CD SET 1,L 
CB 9D RES 3,L CB CE SET 1,(HL) 
CB 9E RES 3,(HL) CB CF SET 1,A 
CB 9F RES 3,A CB DO SET 2,B 
CB AO RES 4,B CB D1 SET 2,C 
CB Al RES 4,C CB D2 SET 2,D 
CB A2 RES 4,D CB D3 SET 2,E 
CB A3 RES 4,E CB D4 SET 2,H 
CB A4 RES 4,H CB D5 SET 2,L 
CB Ad RES 4,L CB D6 SET 2,(HL) 
CB A6 RES 4,(HL) CB D7 SET 2,A 
CB AT RES 4,A CB D8 SET 3,B 
CB A8& RES 5,B CB D9 SET 3,C 
CB AY RES 5,C CB DA SET 3,D 
CB AA RES 5,D CB DB SET 3,E 
CB AB RES 5,E CB DC SET 3,H 
CB AC RES 5,H CB DD SET 3,L 
CB AD RES 5,L CB DE SET 3,(HL) 
CB AE RES 5,(HL) CB DF SET 3,A 
CB AF RES 5A CB EO SET 4,B 
CB BO RES 6,B CB El SET 4,C 
CB B1 RES 6,C CB E2 SET 4,D 
CB B2 RES 6,D CB E3 SET 4,E 
CB B3 RES 6,E CB E4 SET 4,H 
CB B4 RES 6,H CB E5 SET 4,L 
CB Bb RES 6,L CB E6 SET 4,(HL) 
CB B6 RES 6,(HL) CB E7 SET 4,A 
CB B7 RES 6, CB E8 SET 5,B 
CB B8 RES 7,B CB E9 SET 5,C 
CB B9 RES 7,C CB EA SET 5,D 
CB BA RES 7,D CB EB SET 5,E 
CB BB RES 7,E CB EC SET 5,H 
CB BC RES 7,H CB ED SET 5,L 
CB BD RES 7,L CB EE SET 5,(HL) 
CB BE RES 7,(HL) CB EF SET 5,A 
CB BF RES 7,A CB FO SET 6,B 
CB CO SET 0,B CB Fl SET 6,C 
CB Cl SET 0,C CB F2 SET 6,D 
CB C2 SET 0,D CB F3 SET 6,E 
CB C3 SET 0,E CB F4 SET 6,H 
CB C4 SET 0,H CB F5 SET 6,L 
CB Cd SET 0,L CB F6 SET 6,(HL) 
CB C6 SET 0,(HL) CB F7 SET 6,A 
CB C7 SET 0,A CB F8 SET 7,B 
CB C8 SET 1,B CB F9 SET 7,C 
CB C9 SET 1,C CB FA SET 7,D 
CB CA SET 1,D CB FB SET 7,E 
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D4 nnnn 


*¥ ¥ %¥ *¥ He He He He eH Ke HE 


x ¥ 


Mnemonic 
SET 7,L 
SET 7,(HL) 
SET 7,A 
CALL Z,nnnn 
CALL nnnn 
ADC A,nn 
RST 8 
RET NC 
POP DE 
JP NC, nnnn 
OUT = _(nn),A 
CALL NC,nnnn 
PUSH DE 
SUB nn 
RST 10H 
RET C 
EXX 
JP C, nnnn 
IN A, (nn) 
CALL C,nnnn 
ADD  1X,BC 
ADD  IX,DE 
LD TX, nnnn 
LD (nnnn) IX 
INC IX 
ADD IX,IX 
LD TX, (nnnn) 
DEC IX 
INC (IX+dd) 
DEC (IX+dd) 
LD ({X+dd), nn 
ADD _ IX,SP 
LD B,(TX+dd) 
LD C,([X+dd) 
LD D,(IX+dd) 
LD B,(IX+dd) 
LD H,(IX+dd) 
LD L,(IX+dd) 
LD ({X+dd),B 
LD (IX+dd),C 
LD (IX+dd),D 
LD (IX+dd),E 
LD (IX+dd),H 
LD (IX+dd),L 
LD (IX+dd),A 
LD A,(IX+dd) 
ADD A,(TX+dd) 
ADC A,(TX+dd) 
SUB (IX+dd) 


DD 96dd 


DD 9Edd 

DD A6édd 

DD AEdd 

DD Bédd 

DD BEdd 

DD CBdd06 
DD CBdd0E 
DD CBdd16 
DD CBdd1E 
DD CBdd26 
DD CBdd2E 
DD CBdd3E 
DD CBdd46 
DD CBdd4E 
DD CBdd5d6 
DD CBdd5E 
DD CBdd66 
DD CBdd6E 
DD CBdd76 
DD CBdd7E 
DD CBdd86 
DD CBdd8E 
DD CBdd96 
DD CBdd9E 
DD CBddA6 
DD CBddAE 
DD CBddB6 
DD CBddBE 
DD CBddC6 
DD CBddCE 
DD CBddD6 
DD CBddDE 
DD CBddE6 
DD CBddEE 
DD CBddF6 
DD CBddFE 


Mnemonic 
SBC A,(TX+dd) 
AND (IX+dd) 
XOR (IX+dd) 
OR (IX+dd) 
CP (IX+dd) .. 
RLC (IX+dd) 
RRC (IX+dd) 
RL (IX+dd) 
RR ([X+dd) 
SLA (IX+dd) 
SRA (IX+dd) 
SRL (IX+dd) 
BIT 0,([X+dd) 
BIT 1,([X+dd) 
BIT 2,([X+dd) 
BIT 3,([X+dd) 
BIT 4,(IX+dd) 
BIT 5,(IX+dd) 
BIT 6,([X+dd) 
BIT 7,(1X+dd) 
RES 0,([X+dd) 
RES 1,(IX+dd) 
RES 2,([IX+dd) 
RES 3,(1X+dd) 
RES 4,(IX+dd) 
RES 5,([X+dd) 
RES 6,([X+dd) 
RES 7,(1X+dd) 
SET 0,([X+dd) 
SET 1,1X+dd) 
SET 2,([X+dd) 
SET 3,([X+dd) 
SET 4,(IX+dd) 
SET 5,([X+dd) - 
SET 6,([X+dd) 
SET 7,([X+dd) 
POP IX 
EX (SP),IX 
PUSH IX . 

JP (TX) 

LD SP, IX 
SBC A,nn 
RST 18H 
RET PO 

POP HL 

JP PO, nnnn 
EX (SP),HL 
CALL PQ, nnnn 
PUSH HL 
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Hex Mnemonic Hex Mnemonic 
E6 nn * AND nn ED A2 INI 
E7 * RST 20H ED A3 OUTI 
E8 * RET PE ED A8 LDD 
E9 * JP (HL) ED A9 CPD 
EA nnnn * JP PE, nnnn ED AA IND 
EB * EX DE,HL ED AB OUTD 
EC nnnn * CALL PE, nnnn ED BO LDIR 
ED 40 IN B,(C) ED Bi CPIR 
ED 41 OUT = (C),B ED B2 INIR 
ED 42 SBC HL,BC ED B3 OTIR 
ED 48nnnn LD (nnnn),BC ED B8 LDDR 
ED 44 NEG ED B9 CPDR 
ED 45 RETN ED BA INDR 
ED 46 IM 0 ED BB OTDR 
ED 47 LD LA EE nn * XOR N 
ED 48 IN C,(C) EF * RST 28H 
ED 49 OUT  (C),C FO * RET  P 
ED 4A . ADC HL,BC FI * POP AF 
ED 4Bnnnn LD BC, (nnnn) F2 nnnn * JP P, nnnn 
ED 4D RETI F3 * DI 
ED 4F LD R,A F4 nnnn * CALL  P,nnnn 
ED 50 IN DC) F5 * PUSH AF 
ED 51 OUT (C),D F6 nn * OR nn 
ED 52 SBC HL,DE F7 * RST 30H 
ED 58nnnn LD (nnnn),DE F8 * RET M 
ED 56 IM 1 FQ * LD SP,HL 
ED 57 LD Aj FA nnnn * JP M, nnnn 
ED 58 IN E,(C) FB * EI 
‘ED 59 OUT  (C),E FC nnnn * CALL M,nnnn 
ED 5A ADC HL,DE FD 09 ADD _ IY,BC 
ED 5Bnnnn LD DE, (nnnn) FD 19 ADD _ IY,DE 
ED 5E IM 2 FD 21nnnn LD TY, nnnn 
ED 5F LD A,R FD 22nnnn LD (nnnn),TY 
ED 60 IN H,(C) FD 23 INC TY 
ED 61 OUT  (C),H FD 29 ADD _ IY,IY 
ED 62 SBC HL,HL FD 2Annnn LD TY, (nnnn) 
ED 67 RRD FD 2B DEC IY 
ED 68 IN L,(C) FD 34dd INC (TY +dd) 
ED 69 OUT (C),L FD 35dd DEC  (IY+dd) 
ED 6A ADC  HL,HL FD 36ddnn LD (TY+dd), nn 
ED 6F RLD FD 39 ADD _ IY,SP 
ED 72 SBC HL,SP FD 46dd LD B,(TY+dd) 
ED 738nnnn LD (nnnn),SP FD 4Edd LD C,(TY+dd) 
ED 78 IN A,(C) FD 56dd LD D,(1Y+dd) 
ED 79 OUT (C),A FD 5Edd LD E,(1Y+dd) 
ED 7A ADC HL,SP FD 66dd LD H,(TY+dd) 
ED 7Bnnnn LD SP, (nnnn) FD 6Edd LD L,(1Y+dd) 
ED AO LDI FD 70dd LD (TY+dd),B 
ED Al CPI FD 71dd LD (1¥+dd),C 


-—mamaceneenenssenseunasrtnaninnsensten eines nenhnnsteasnsnnsnaneienitetbanantnhpesntnerermsesensenterenemninminrtnesterecneuens 
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Hex Mnemonic Hex Mnemonic 
FD 72dd LD (TY+ddq), FD CBdd6E BIT 5,(TY+dd) 
FD 73dd LD (TY+dd),E FD CBdd76 BIT 6,(1Y+dd) 
FD 74dd LD (TY¥+dd),H FD CBdd7E BIT 7,(1Y+dd) 
FD 75dd LD (T¥+dd),L FD CBdd86 RES 0,(TY+dd) 
FD 77dd LD (T¥+dd),A FD CBdd8E RES 1,1Y+dd) 
FD 7Edd LD A,(TY+dd) FD CBdd96 RES 2,(1¥+dd) 
FD 86dd ADD A,j(TY+dd) FD CBdd9E RES 3,(TY+dd) 
FD 8Edd ADC A,(TY+dd) FD CBddA6 RES 4,(1Y+dd) 
FD 96dd SUB (TY+dd) FD CBddAE RES 5,(TY+dd) 
FD 9Edd SBC A,(IY+dd) FD CBddB6 RES 6,(TY+dd) 
FD A6dd AND (IY¥+dd) FD CBddBE RES 7,1Y+dd) 
FD AEKdd XOR (IY¥+dd) FD CBddC6 SET 0,(1Y+dd) 
FD Bédd OR (TY+dd) FD CBddCE SET 1,(1Y+dd) 
FD BEdd CP (TY+dd) FD CBddD6 SET 2,(T¥+dd) 
FD CBdd06 RLC (TY+dd) FD CBddDE SET 3,(TY+dd) 
FD CBdd0E RRC (1¥+dd) FD CBddE6 SET 4,(1Y+dd) 
FD CBddi16 RL (TY+dd) FD CBddEE SET 5,(1Y+dd) 
FD CBdd1iE RR (IY+dd) FD CBddF6 SET 6,(1Y+dd) 
FD CBdd26 SLA (T¥+dd) FD CBddFE SET 7,(T¥+dd) 
FD CBdd2E SRA (TY¥+-dd) FD El POP IY . 
FD CBdd3E SRL (TY+dd) FD E3 EX (SP), TY 
FD CBdd46 BIT 0,(1Y+dd) FD E5 PUSH IY 
FD CBdd4E BIT 1,(TY+dd) FD E9 JP (IY) 
FD CBdd56 BIT 2,(1Y+dd) FD F9 LD SP, TY 
FD CBddd5E BIT 3,(1Y+dd) FE nn * CP nn 
FD CBdd66 BIT 4,(1Y+dd) FF * RST 38H 
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Cross-Reference of 
8080 and Z-80 Instructions 


The instructions are listed in alphabetic order according to the 8080 
mnemonic. The following representations are used. 


N 8-bit constant 

NN 16-bit constant 

R single register 

RR_ double register 

oa range of values expressed as one character 
—-— _ range of values expressed as two characters 


8080 HEX Z-80 
code code code 
ACI N CE ADC A,N 
ADC M 8E ADC A,(HL) 
ADC R S= ADC A,R 
ADD M 86 ADD A,(HL) 
ADD R 8— ADD A,R 
ADI N C6 ADD AN 
ANA M A6 AND (HL) 
ANA R A- AND R 
ANI N E6 AND N 
CALL NN CD CALL NN 
CC NN — DC CALL C,NN 
CM NN FC CALL M,NN 
CMA 2F CPL 
CMC 3F CCF 
CMP M BE CP (HL) 
CMP R B- CP 
CNC NN D4 CALL NC,NN 
CNZ NN C4 CALL NZ,NN 
CP NN F4 CALL P,NN 
CPE NN EC CALL PE,NN 
CPI N FE CP N 
CPO NN E4 CALL PO,NN 
CZ NN CC CALL Z,NN 
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8080 
code 
DAA 
DAD B 
DAD D 
DAD H 
DAD SP 
DCR M 
DCR R 
DCX B 
DCX D 
DCX H 
DCX SP 
DI 
EI 
HLT 
IN N 
INR M 
INR R 
INX B 
INX D 
INX H 
INX SP 
JC NN 
JM NN 
JMP NN 
INC NN 
INZ NN 
JP NN 
JPE NN 
JPO NN 
JZ NN 
LDA NN 
LDAX B 
LDAX D 
LHLD NN 
LXI B,NN 
LXI D,NN 
LXI H,NN 
LXI SP,NN 
MOV M,R 
MOV RM 
MOV R,R2 
MVI M,N 
MVI R,N 
NOP 
ORA M 
ORA R 
ORI N 
OUT N 
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282 
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8080 
code 


PCHL 
POP 


a eae 


= 


ZPAmeze AMMAR WNHOS 
Zz 


4 


250 = Zw = ows 


APPENDIX H 


Details of the Z-80 
and 8080 Instruction Set 


A summary of the Z-80 and 8080 instruction set is given in this appendix.* 
The instructions are listed alphabetically by the official Zilog mnemonic. If 
there is a corresponding 8080 instruction, the Intel mnemonic is shown in 
angle brackets; if not, ‘‘no 8080” is shown in the angle brackets. The Z-80 
mnemonics are listed in numeric order in Appendix F. The Z-80 equivalent 
of an 8080 mnemonic can be found from the cross-reference given in 
Appendix G. 

The letters A, B, C, D, E, H, I, L, IX, ITY, R, and SP are used for the 
standard Z-80 register names. In addition, the symbols BC, DE, and HL are 
used for the register pairs. The following symbols are used for general 
arguments. 


r,r2 98-bit CPU register 

dd 8-bit signed displacement 
nn general 8-bit constant 
nnnn 16-bit constant 


The flag bits are represented by: 


C carry 

H half carry 

N add/subtract 
P/O  parity/overflow 
S sign 

Z zero 


Pointers to memory or input or output addresses are enclosed in parentheses. 


*More details can be obtained from the Zilog programmer’s manual, Z-80 Assembly 
Language Programming Manual, Zilog, Inc., 1977. 
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ADC As CHL) <ADC M> 


Add the memory byte pointed to by the HL register pair to the accumulator 
~and the carry flag. The result is placed in the accumulator. 


Flags affected: C, H, O,S, Z 
Flag reset: N 


ADC As (IXtdd) <no 8080> 
ADC Ay (1Y¥+dd) =no 8080> 


Add the memory byte referenced by the sum of the specified index register 
and the displacement to the accumulator and the carry flag. The result is 
- placed in the accumulator. 


Flags affected: C, H, O, 8, Z 
Flag reset: N 


ADC Avr “ABDC ro 


Add the value in register r to the accumulator and the carry flag. The result 
is placed in the accumulator. 


Flags affected: C, H, O, S, Z, 
Flags reset: N 


ADC Asnr <ACI mri 


Add the constant’ given in the second operand to the accumulator and the 
carry flag. The result is placed in the accumulator. 

Flags affected: C, H, O, S, Z . 

Flag reset: N 


ADC HL » BC <no 8080> 
ADC HL » DE <no 8080> 
ADC HL » HL “no 8080> 
ADC HL » SF “no B8080> 


Add the indicated double register to the HL poeisier and the carry flag. The 
result is placed in HL. 


Flags affected: C, H, O, S, Z, 
Flag reset: N 


ADD Ay CHL) “ADD Mo 


_ Add the memory byte pointed to by the HL pair to the accumulator. The 
result is placed in the accumulator. 


_ Flags affected: C, H, O, 8, Z 
Flag reset: N 
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ADL Avs(IXtdd) <=no 8080> 
ADD As(1¥t+tdd) <mo 8080> 


Add the memory byte pointed to by the sum of the specified index register 
and the displacement to the accumulator. The result is placed in the accumu- 
lator. 

Flags affected: C, H, O, 8, Z 

Flag reset: N 


ADD Arr <ADD Te 


Add the value in register r to the accumulator. The result is placed in the 
accumulator. 


Flags affected: C, H, O, 8, Z 
Flag reset: N 


ADD Agynn <ADnT nr 


Add the immediate byte (the second operand) to the accumulator. The 
result is placed in A. 

Flags affected: C,H, O,5, Z 

Flag reset: N 


ADD HL » BC <DAD B> 
ADD HL » DE <DAn It> 
ADD HL. » HL <DAD H> 
Abn HL » SP “DAD SF 


Add the specified double register to the HL pair. The result is placed in HL. 
This is a double-precision addition. The carry flag is set if an overflow 
occurs. The instruction ADD HL,HL performs a 16-bit arithmetic shift left, 
effectively doubling the value in HL. The ADD HL,SP instruction can be 
used with the 8080 CPU to save an incoming stack pointer: 


LXI H,0 
DAD SP 
SHLD nnnn 


Flags affected: C, H, O, 5, Z 
Flag reset: N 


ADD IX» BC <no BO80> 
ADD IX» DE <no 8000> 
ADD IX IX <no 8080> 
ADD IX 9 SF <no 8080> 
ABD LY» BC <no 80802 
ADD ITY » DE tna 8080> 
AUD TYsIY <no 8080+ 


ADD IY 9 SP tno 8080> 
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ee 
Add the indicated double register to the specified index register. The result 
is placed in the index register. The HL register pair does not participate in 
this group of instructions. Notice that there is no equivalent series of ADC 
instructions. 


Flags affected: C,O,S, Z 
Flag reset: N 


AND (HL) <ANA Mo 


Perform a logical AND with the accumulator and the memory location 
pointed to by the HL register pair. The result is placed in the accumulator. 


Flags affected: P, S, Z 
Flags reset: C, N 


Flag set: H 
AND (IXtdd) “no BOs0> 
AND (1¥+dd) <no 8080> 


Perform a logical AND with the accumulator and the memory byte refer- 
enced by the sum of the index register and displacement. The result is 
placed in the accumulator. 


- Flags affected: P, S, Z 
Flags reset: C, N 
Flag set: H 


AND a <ANA re 


Perform a logical AND with the accumulator and register r. The result is 
placed in the accumulator. An instruction AND A is an effective way to test 
the parity, sign, and zero flags. 


Flags affected: P,S, Z 
Flags reset: C, N 
Flag set: H 


AND mn > <ANI ns 


Perform a logical AND with the accumulator and the constant given in the 
argument. The result is placed in the accumulator. This instruction can be 
used to selectively reset bits of the accumulator. For example, the instruc- 
tion AND 7FH will reset bit 7. 


Flags affected: P, S, Z 
Flags reset: C, N 
Flag set: H 
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BIT be CHL) “no 8O80> 
BIT be CIX+dd) “no 8080> 
BIT be (1Y¥+dd) =no 8O80> 


Test bit b of the memory byte referenced by the second operand. Bit b can 
range from zero through 7. The zero flag is set if the referenced bit is a 
logical 1; otherwise, it is reset. Thus, the zero flag becomes the complement 
of the selected bit. 


Flag affected: Z 
Flag set: H 
Flag reset: N 


BIT bor “no 8080> 


Test bit b of register r, where b can range from zero through 7. The zero flag 
is set if the referenced bit is a logical 1. It is reset otherwise. 


Flag affected: Z 
Flag set: H 
Flag reset: N 


CALL mmrre “CALL nnn 


Unconditional subroutine call to address nnnn. The address of the following 
instruction is pushed onto the stack. 


Flags affected: none 


CALL Ce nmrrn <cc nonce 
CALL Mennnn <CM ninrre> 
CALL NC ennmn <CNC nnn 
CALL NZ ennnmrn “CNZ nnn 
CALL Poenmnmnn <CF nnn 
CALL PE smnmm “CPE nor 
CALL FOsmnnrn <CFO nner 
CALL Z2nnnn CZ nmnti 


Conditional subroutine call to address nnnn. The address of the following 
instruction is pushed onto the stack. The conditions are: 


C carry flag set (carry ) 

M sign flag set (minus) 
NC carry flag reset (not carry) 
NZ __ zero flag reset (not zero) 


P sign flag reset (plus) 
PE parity flag set (parity even) 
PO parity flagreset (parity odd) 
Z zero flag set (zero) 
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CCF < CMC > 
Complement the carry flag. This instruction can be given after a SCF com- 
mand to reset the carry flag. 


Flag affected: C 
Flag reset: N 


CP CHL > <CMF M> 


Compare the byte in memory pointed to by the HL pair to the accumulator 
(an implied operand). The zero flag is set if the accumulator is equal to the 
- operand. The carry flag is set if the accumulator is smaller than the operand. 


Flags affected: C,H, O, 8S, Z 


Flag set: N 
CP (IX+dd) <no 8080> 
Cr (1Y¥+dd) <noa 8080> 


Compare the memory location referenced by the sum of the index register 
and displacement to the accumulator which is an implied operand. The zero 
flag is set if the accumulator is equal to the operand. The carry flag is set if 
the accumulator is smaller than the operand. 


Flags affected: C, H, O,S, Z 
Flag set: N 


cr r <CMF r> 


Compare register r to the accumulator, which is an implied operand. The 
zero flag is set if the accumulator is equal to the operand. The carry flag is 
set if the accumulator is smaller than the operand. 

Flags affected: C, H, O, 8, Z 

Flag set: N 


CF mm <CFI nn 


Compare the constant given in the operand to the accumulator, which is an 
implied operand. The zero flag is set if the accumulator is equal to the 
operand. The carry flag is set if the accumulator is smaller than the operand. 


Flags affected: C,H, O,S, Z 


Flag set: N 

CFI tno 8OB80> 
CPDR <no 8080> 
CFI sno 8080> 


CPIR <no 8080> 
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Compare the memory byte pointed to by HL to the accumulator. Decrement 
HL (if D) or increment HL (if I). Decrement the byte count in the BC regis- 
ter. Repeat the operation for CPDR and CPIR until a match is found or 
until the BC register pair has been decremented to zero. The zero flag is set 
if a match is found. The parity flag is set if BC is decremented to zero. 


Flags affected: H,S 
Flags set: N, Zif A = (HL), Pif BC =0 


CPL < CMA > 


Complement the accumulator. This instruction performs a one’s comple- 
ment on the accumulator. (Compare to the instruction N KG.) 


Flags set: H, N 


DAA < DAA > 


Decimal adjust the accumulator. This instruction is used after each addition 
with BCD numbers. The Z-80 performs this operation properly for both 
addition and subtraction. The 8080, however, gives an incorrect result for 
subtraction. 


Flags affected: O,S, Z, C,H 


DEC CHL > <DCR M> 
Decrement the memory byte pointed to by the HL register pair. 


Flags affected: H, O,S, Z 
Flag set: N 
Flag not affected: C 


DEC (IxX+dd) sno 8080> 
DEC (1Y¥+dd> “no 8080> 


Decrement the memory byte pointed to by the sum of the index register 
and the displacement. 


Flags affected: H, O, S, Z 
Flag set: N 
Flag not affected: C 


BEC r <D0CK TS 


Decrement the register r. Don’t try to decrement a register past zero while 
executing a JP NC loop. The carry flag is not affected by this operation. 


Flags affected: H, O, S, Z 
Flag set: N 
Flag not affected: C 
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DEC BC “DCX B> 


DEC BE <DCX D> 
DEC HL <DCX H> 
DEC SP “DCX SF > 


'Decrement the indicated double register. Don’t try to decrement a double 
‘register to zero in a JP NZ loop. It won’t work since this operation does not 
affect any of the PSW flags. Instead, move one byte of the double register 
into the accumulator and perform a logical OR with the other byte. 


LD A,C 
OR B 
JR NZ,nnnn 
Flags affected: none!!!! 
DEC IX “no 8O080> 
HEC LY =no B8080> 


Decrement the index register. 


Flags affected: none 


DI < OT > 


Disable maskable interrupt request. 


DINZ dd “no 8080> 


Decrement register B and jump relative to displacement dd if B register is 
not zero. 


Flags affected: none 


ET < EI > 


Enable maskable interrupt request. 


EX (SP) » HL = XTHL > 


Exchange the byte at the stack pointer with register L. Exchange the byte at 
the stack pointer + 1 with register H. 


Flags affected: none 


EX (SF) » IX “no 8080> 
EX (SP) oTY <no B8080> 


Exchange the 16 bits referenced by the stack pointer with the specified 
index register. 


Flags affected: none 
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EX «AF SAF’ ne 8O080> 
Exchange the accumulator and flag register with the alternate set. | 
Flags affected: all 


EX DE » HL < XCHG > 
Exchange the double registers DE and HL. 


Flags affected: none 


EXX <no 8080> 
Exchange BC, DE, and HL with the alternate set. 


Flags affected: none 


HALT « HLT > 


Suspend operation of the CPU until a reset or interrupt occurs. Dynamic 
memory refresh continues during a halt. 


IM 0 <no 80B80> 
IM i xno 8O080> 
IM 2 xno 8080> 


Sets interrupt mode 0, 1, or 2. Interrupt mode 0 is automatically selected 
when a Z-80 reset occurs. The result is the same as the 8080 interrupt 
response. Interrupt mode 1 performs an RST 38H instruction. Interrupt 
mode 2 provides for many interrupt locations. | 


IN re (Ct) <noe B8OB80> 


g 
Input a byte from the port address in register C to register r. 


Flags affected: P,S, Z 
Flags reset: H, N 


IN A» (nn) <IN nin 
Input a byte from the port address nn to the accumulator. 


Flags affected: none 


INC CHL) <INR M> 
Increment the memory byte pointed to by the HL pair. 


Flags affected: H, O, 8S, Z 
Flag set: N 
Flag not affected. C!!!! 
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INC (IX+dd) <no 8oB0> 
INC C1Y¥+dd) “no 8080> - 


Increment the memory byte pointed to by the sum of the index register and 
the displacement. 


Flags affected: H, O, 5, Z 
Flag set: N 
Flag not affected: C!!! 


INC r <INR r> 


Increment the 8-bit register r. Don’t try to increment a register past zero 
while executing a JP NC loop. It won’t work because the carry flag is unaf- 
fected by this instruction. 


Flags affected: H, O,S, Z 
Flag set: N 
Flag not affected: C!!! 


INC BC <INX B> 
INC DE SINX D> 
INC HL. “TNX H> 
INC SP <INX SP 


Increment the specified double register. 
Flags affected: none!!!! 
INC Ix “no BO80O> 
INC ly sno 8080> 
Increment the specified index register. 


Flags affected: none 


IND <no 8080 > 
INDR <no 8080> 
INI <no 8080> 
INIR xno 8080> 


Input a byte from the port address in register C to the memory byte pointed 
to by HL. Decrement register B. The HL register is incremented (if I) or 
decremented (if D). For INDR and INIR the process is ac until the 
8-bit register B becomes zero. 


Flag affected: Z (if B = 0) 
Flag set: N 
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JF CHL > < PCHL > 


Copy the HL register pair into the program counter; then retrieve the next 
instruction from the address referenced by HL. This instruction causes a 
jump to the address referenced by HL. 


Flags affected: none 


JP (IX) <no BOB0> 
JF (IY) <no 8080> 


Copy the contents of the specified index register into the program counter; 
then retrieve the next instruction from the address referenced by IX or IY. 


Flags affected: none 


JP ANMr < IMP nnnn> 
Unconditional jump to address nnnn. 


Flags affected: none 


JF Ceonnmnn LIC nnn 
JF Mennnn <JM cnannn> 
JF NC onnmnn <JINC nminmn> 
JF NZ ynnnn <JINZ nnann> 
JP Poemnmnn “JF nnann> 
JP PE snnnn <JIPE nnn 
JF POr nnn «JPO nnn 
JP Zennnn LJIZ nannrn> 


Conditional jump to address nnnn where: 


C means carry flag set (carry ) 

M means sign flag set (minus) 

NC means carry flag reset ~(not carry) 
NZ _ means zero flag reset (not zero) 

P means sign flag reset (plus) 

PE means parity flagset (parity even) 
PO means parity flag reset (parity odd) 
Z means zero flag set (zero) 


JR dd “no 8080> 


Unconditional relative jump with a signed displacement nn. The jump is 
limited to 129 bytes forward and 126 bytes backward in memory. 


Flags affected: none 
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JR Crdd “no 8080> 
JR NC edd “no 8080> 
JR NZ ode <no 8080> 
JR Zed “no 8080> 


- Conditional relative jump to address nn where: 


C means carry flag set (carry) 
NC means carry flagreset (not carry) 
NZ means zero flagreset (not zero) 


Z means zero flag set (zero) 
Lr (BC) 9A <STAX B> 
Lio (DE) A “=STAX D> 


Move the byte in the accumulator to the memory byte referenced by the 
specified register pair. 


LD CHL) er <MOV Mor 
_Move the byte in register r to the memory byte pointed to by the HL pair. 


LD CHL) enn <MVI Menn> 


Move the immediate byte nn into the memory byte referenced by the HL 
pair. 


LD (IXtdd)yr xno 8080> 
LD (IXtdd) smn “mo 8080> 
LD CLl¥+¢dd)er <no 8080> 
LD (1TY¥+dd) »nn 


Move the byte in register r or the immediate byte nn into the memory byte 
referenced by the sum of the index register plus the displacement. These 
instructions can be used to load relocatable binary code. 


LD CnnnndvA <STA nnn 


Store the accumulator in the memory location referenced by nnnn. 


LO Cnmnn> » BC <no 8O080> 
Lo Cnnmn) » GE xno 8O080> 


Store the low-order byte (C or E) of the specified double register at the 
memory location nnnn. Store the high-order byte (B or D) at nnnn + 1. 


LD Cnamm) » HL <SHLD nan 


Store register L at the memory address nnnn. Store register H at the address 
nnnn + 1. 
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LD (nmr) » IX “no B08O> 
LD Cninnmr) » TY <no 8080> 
LD C(nnnmn) 2 SP “no 8080> 


Store the low-order byte of the specified register IX, IY, or SP at the 
location nnnn. Store the high-order byte at nnnn + 1. The instruction 
LD (nnnn),SP can be used to temporarily save an incoming stack pointer. It . 
can later be restored by a LD SP,(nnnn) operation. . 


oe Lae amen re 


LD fy (BC) <LDAX > 
Lo A» (DE) =LDAX D> 


Move the memory byte referenced by the specified register pair BC or DE 
into the accumulator. : 


eer eine mars erent ren 


LO Avl <no B080> 


Load the accumulator from the interrupt-vector register. The parity flag 
reflects the state of the interrupt-enable flip-flop. 


Flags affected: S, Z, P 
Flags reset: H, N 


LD Ag <no 8O080> 


Load the accumulator from the memory-trefresh register. The parity flag 
reflects the state of the interrupt-enable flip-flop. This is an easy way to 
obtain a fairly decent random number. 


Flags affected: S, Z, P | 
Flags reset: H, N 


—eeesient 


Lit IvA <no 8080> 
Copy the accumulator into the interrupt-vector register. 


Flags affected: none 


LD ReA <no 8080> 


Copy the accumular into memory-refresh register. 


Flags affected: none 


LO ry CHL) <MOV reh> 


Move the byte in the memory location pointed to by the HL register pair 
into register r. 


Core tee Ss en ee 
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Lo ry (IXt+dd) xno 8080> 
LO re (Il¥tdd) <no BO080> 


~Move the byte at the memory location referenced by the sum of the index 
register and the displacement into register r. 


Lp rer2 <MOV pera 


Move the byte from register r2 to r. 


LD renn <MVI ren 


Load register r with the 8-bit data byte nn. 


LB Ar Cnnann) <LBA nnn 


Load the accumulator from the memory byte referenced by the 16-bit 
pointer nnnn. 


LD BC» (mmnn) <mro 80802 
Lo BE » (mmm) <no 8080> 


Load the low-order byte (C or E) from the location referenced by the 16-bit 
pointer nnnn. Load the high-order byte (B or D) from nnnn + 1. 


LD HL » C(nnmm) “LHL D nnnre> 


Load register L from the address referenced by the 16-bit value nnnn. Load 
register H from the address nnnn + 1. 


LD BC ynnnn <LXI Boennnn> 
Lo BE snonn ; <LXI DBrnnnn> 
Li HL snnnn <LXI Hennmn> 
Lo SP snnmmn <LXI SPs nnnn> 
Lo IXennnn ina B0G0> 
LD LY esnnnn “mo 8080> 


Load the specified double register with the 16-bit constant nnnn. Be careful 
not to confuse LD HL,(nnnn) with LD HL,nnnn. 


Lot IX? (nnnr =no 8080> 
LD TY * (nann) <no 8080O> 
LO SP» (nnn) <no 8O80> 


‘ Load the low byte of IX, TY, or SP from the memory location nnnn. Load 
the high byte from nnnn + 1. The LD SP,(nnnn) instruction can be used to 
retrieve a previously saved stack pointer. 
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Lo SP» HL « SPHL > 
LD SP» 1X <no 80802 
LD SPs LY <no 8080> 


Load the stack pointer from the specified 16-bit register. The SPHL instruc- 
tion can be used to retrieve a previously saved stack pointer when the 8080 
CPU is used. 


LHLD nnnn 
SPHL 

LBD <no 8080> 

LDDR «no B8O8O> 

Lor <no 8O80O> 

LBIR “no 8080> 


Move the byte referenced by the HL pair into the location pointed to by 
the DE register pair. Decrement the 16-bit byte counter in BC. Increment 
(if I) or decrement (if D) both HL and DE. Repeat the operation for LDDR 
and LDIR until the BC register has been decremented to zero. 


NEG xno 80807 


This instruction performs a two’s complement on the accumulator. It | 
effectively subtracts the accumulator from zero. To perform this task on an 
8080, use a CMA command followed by an INR A command. 


Flags affected: all 


NOP < NOP > 
No operation is performed by the CPU. 


Flags affected: none 


OR (HL)? <ORA M> 


Perform a logical OR with the accumulator and the byte referenced by HL. 
The result is placed in the accumulator. 


Flags affected: P,S, Z 
Flags reset: C, H, N 


OR CIX+dd) <no 8080> 
OR (L¥tdd) “no 8080> 


Perform a logical OR with the accumulator and the byte referenced by the 
specified index register plus the displacement. The result is placed in the 
accumulator. 


Flags affected: P, S, Z 
Flags reset: C, H, N 
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OR r <ORA re 


Perform a logical OR with the accumulator and the register r. The result is 
placed in the accumulator. An instruction of OR A is an efficient way to 
test the parity, sign, and zero flags. 


Flags affected: P, S, Z 
Flags reset: C, H, N 


OR nm “ORY ms 


Perform a logical OR with the accumulator and the byte nn. The result is 
placed in the accumulator. This instruction can be used to set individual bits 
of the accumulator. For example, OR 20H will set bit 5 to a logical 1. 


Flags affected: P,S, Z 
Flags reset: C, H, N 


OTDR <no 8080> 
OTIR <no B8080> 


Output a byte from the memory location pointed to by the HL pair. The 
port address is contained in register C. Register B is decremented. The HL 
register pair is incremented (if I) or decremented (if D). The process is 
repeated until register B has become zero. 


Flags set: N, Z 


OUT (Cor <na 8O8o0> . 
Output the byte in register r to the port address contained in register C. 


Flags affected: none 


OUT (rind 9A SOUT mms 
Output the byte in the accumulator to the port address nn. 


Flags affected: none 


OUTD xno 8080> 
OUTI “no BO80> 


Output a byte from the memory location pointed to by the HL pair. The 
port address is contained in register C. Register B is decremented. The HL 
register pair is incremented (if I) or decremented (if D). 


Flag affected: Z 
Flag set: N 
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FOP AF <POF PSW> 


Move the byte at the memory location referenced by the stack pointer into 
the flag register (PSW), and increment the stack pointer. Then move the 
byte at the location referenced by the new stack-pointer value into une 
accumulator and increment the stack pointer a second time. 


Flags affected: all 


FOF BC <POP BD 
FOF DE <POP = D> 
FOP HL <FOP = H> 


Copy two bytes of memory into the appropriate double register as follows. 
The memory byte referenced by the stack pointer is moved into the low- 
order byte (C, E, or L), then the stack pointer is incremented. The memory 
byte referenced by the new stack pointer is then moved into the high-order © 
byte (B, D, or H). The stack pointer is incremented a second time. 


Flags affected: none 


FOF Ix mo 8080> 
FOF IY <no 8080> 


Copy the top of the stack into the specified index register. Increment the . 
stack pointer twice. 


Flags affected: none 


PUSH AF “PUSH PSW> 


Store the accumulator and flag register in memory as follows. The stack 
pointer is decremented, then the value in the accumulator is moved to the 
memory byte referenced by the stack pointer. The stack pointer is decre- 
mented a second time. The flag register is copied to the byte at the memory 
address referenced by the current stack-pointer position. 


Flags affected: none 


FUSH BC “PUSH Re 
FUSH DE “PUSH [i> 
FUSH HL. <PUSH He 


Store the referenced double register in memory as follows. The stack pointer 
is decremented, then the byte in the specified high-order register B, D, or H 
is copied to the memory location referenced by the stack pointer. The stack 
pointer is decremented a second time. The byte in the low-order position C, 
E, or L is moved to the byte referenced by the current value of the stack 
pointer. 


Flags affected: none 
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“no 8080> 
xno BOBO> 


Ix 
IY 


FUSH 
FUSH 


The indicated index register is copied to the top of the stack. The stack _ 


pointer is decremented twice. 


Flags affected: none 


RES by CHL) <no 80680> 
RES bs (IX+dd) sno 8080> 
RES be (IY +dd) <no 8080> 


Reset bit b of the memory byte referenced by the second operand. Bit b 


can range from zero through 7. 


Flag reset: N 
Other flags affected: none 


RES ber <no 8080> 


Reset bit b of register r to avalue of zero. Bit b can range from zero through 7. 


Flag reset: N 
Other flags affected: none 


RET < RET > 


Return from a subroutine. The top of the stack is moved into the program 
counter. The stack pointer is incremented twice. 


RET Cc < RCO > 
RET M < RM > 
RET NC <= RNC > 
RET NZ < RNZ > 
RET F < oRP > 
RET PE < RPE > 
RET FO x RPO > 
- RET Zz < RZ > 


- Conditional return from a subroutine. If the condition is met, the top of 
the stack is moved into the program counter. The stack pointer is incre- 


mented twice. 


C means carry flag set 

M means sign flag set 
means carry flag reset 
means zero flag reset 
P means sign flag reset 
means parity flag set 
means parity flag reset 
Z means zero flag set 


(carry) 
(minus) 

(not carry) 
(not zero) 
(plus) 
(parity even) 
(parity odd) 
(zero) 
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RETI “no 8080> 


Return from maskable interrupt. 


RETN <no 8080> 


Return from nonmaskable interrupt. 


The following RL and RLA instructions rotate bits to the left through carry. 


Dm me me soe ee a te a Taleo lvatentententententeeteatenten FR ote een cr ere mr a tt et Cr foe ee seo ! 
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carry resister 

RL CHL) <no 80so> 


The memory byte referenced by the HL pair is rotated left through carry. 
The carry flag moves into bit zero. Bit 7 moves to the carry flag. 


Flags affected: C, P,S, Z 
Flags reset: H, N 


RL (IX+dd) «no 8080> 
RL (TY¥t+dd) <no 80802 


The memory byte referenced by the sum of the index register and the dis- 
placement is rotated left through carry. The carry flag moves into bit zero. 
Bit 7 moves to the carry flag. 


Flags affected: C, P, S, Z 
Flags reset: H, N 


RL r sno 8080> 


The byte in register r is rotated left through carry. The carry flag moves into 
bit zero. Bit 7 moves to the carry flag. Note: the instruction RL A performs 
the same task that the separate instruction RLA does, but the former takes 
twice as long as the latter. 


Flags affected: C, P, S, Z 
Flags reset: H, N 


RLA < RAL > 


The byte in the accumulator is rotated left through carry. The carry flag 
moves to bit zero. Bit 7 of the accumulator moves to the carry flag. 
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Flag affected: C 
Flags reset: H, N 


Bm me ee Dh ee Fee ! 
! ' 
faa} j lane heen dl ee lene eae lee tome] Sam | ! 
fo eee tee Col, So, Co Coo Co oo Co eo ore 
becom f Lees Dipti het eek money tiene etn Pane eien} 
carry register 
RLC CHL > no 8080> 


The byte referenced by the HL pair is rotated left circularly. Bit 7 moves to 
both the zero bit and to the carry flag. 

Flags affected: C, P, S, Z 

Flags reset: H, N 


RLC (IxX+dd) <no BOB0> 
RLC (1Y¥+dd) <no 8080> 


The byte referenced by the specified index register plus the displacement is 
rotated left circularly. Bit 7 moves to both bit zero and the carry flag. 


‘Flags affected: C,P,S, Z 
Flags reset: H, N 


RLC r “na 80B80> 


The byte in register r is rotated left circularly. Bit 7 moves to both bit zero 
and the carry flag. Note: RLC A performs the same task that another in- 
struction RLCA does, but the former instruction takes twice as long as the 
latter. 


Flags affected: C,P,S, Z 
Flags reset: H, N 


RLCA “= RLC > 


~The accumulator is rotated left circularly. Bit 7 moves to both bit zero and 
the carry flag. 


Flag affected: C 
Flags reset: H, N 


RLU “no 8080> 


A 4-bit rotation over 12 bits. The low 4 bits of A move to the low 4 bits of 
the memory location referenced by the HL pair. The original low 4 bits of 
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memory move to the high 4 bits. The original high 4 bits move to the low 
4 bits of A. This instruction is used for BCD operations. 


Flags affected: P, 8S, Z 
Flags reset: H, N 


 otaek estate eal oh Seatententents Seal | 
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carry. 
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resister carry 
RR - CHL? xno 8080> 


The memory byte pointed to by the HL pair is rotated right through carry. 
Carry moves to bit 7. Bit zero moves to the carry flag. 


Flags affected: C,P,S, Z 
Flags reset: H, N 


RR CIxX+dd) “no 8080> 
RR (T¥+dd) <no B0B0> 


The memory byte pointed to by the specified index register plus the offset 
is rotated right through carry. The carry flag moves to bit 7. Bit zero moves 
to the carry flag. 


Flags affected: C,P,S, Z 
Flags reset: H, N 


RR r <no BOB0> 


The byte in register r is rotated right through carry. Carry moves to bit 7. 
Bit zero moves to the carry flag. Note: RR A performs the same task that 
another instruction RRA does, but the former instruction takes twice as 
long as the latter. 


Flags affected: C,P,S, Z 
Flags reset: H, N 
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RRA € RAR > 


The accumulator is rotated right through carry. The carry flag moves to 


bit 7. Bit zero moves to the carry flag. 


Flag affected: C 
Flags reset: H, N 


ena rer ssuneauneremar semuvenratnainainaunsinumasmtitrnieasttetentrearaneentnensirtnnes er meenmnemtntnninnti 
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redister carry 
RRC CHL > “nao 8080> 


The memory byte pointed to by the HL pair is rotated right circularly. Bit 
zero moves to both the carry flag and bit 7. 

Flags affected: C,P,S, Z 

Flags reset: H, N 


RRC (IXtdd) “no 8080> 
RRC (TY td) <na 8080> 


The memory byte pointed to by the index register plus the offset is rotated 
right circularly. Bit zero moves to both the carry flag and bit 7. 


Flags affected: C,P,S, Z° 
Flags reset: H, N 


RRO 3 “no B0B0> 


The byte in register r is rotated right circularly. Bit zero moves to both the 
carry flag and bit 7. Note: RRC A performs the same task that another 
instruction RRCA does, but the former instruction takes twice as long as 
the latter. 


Flags affected: C,P, 5S, Z 
Flags reset: H, N 


RRCA < RRC > 


The accumulator is rotated right circularly. Bit zero moves to both the carry 
flag and bit 7. 


Flag affected: C 
Flags reset: H, N 
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RRD <no B8080> 


A'4-bit rotation over 12 bits. The low 4 bits of A move to the high 4 bits of 
the memory location referenced by the HL pair. The original high 4 bits of 
memory move to the low 4 bits. The original low 4 bits move to the low 4 
bits of A. This instruction is used for BCD operations. 


Flags affected: P, S, Z 
Flags reset: H, N 


cleat heeteetee dealt | J mr ne | 
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RST OOH <RST O> 
RST O8H “RST 1> 
RST 10H <RST 2> 
RST 18H <RST 3> 
RST 20H <RST A> 
RST 28H <RST S> 
RST 30H “RST 6> 
RST 38H <RST 7> 


These restart instructions generate one-byte subroutine calls to address given 
in the Z-80 operand. 


SBC Avs CHL) <SEB M> 


Subtract the carry flag and the memory byte pointed to by the HL pair from 
the accumulator. The result is placed in the accumulator. Some Z-80 assem- 
blers allow the 8080 mnemonic of SBB to be used as an alternate Z-80 
mnemonic for this instruction. 


Flags affected: C, H, O, 8, Z 


Flag set: N 
SEC Ay (IX+dd) tno 8080> 
SEC As (1Y¥+tdd) “no B8080> 


Subtract the carry flag and the memory byte pointed to by the sum of the 
index register and displacement from the accumulator. The result is placed 
in the accumulator. 


Flags affected: C,H, O, S, Z 
Flag set: N 
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SBC Apr <SBB r> 


Subtract the carry flag and the specified CPU register from the accumulator. 
The result is placed in the accumulator. Some Z-80 assemblers allow the 
8080 mnemonic of SBB to be used as an alternate Z-80 mnemonic for this 
instruction. 


Flags affected: C,H, O,S, Z 
Flag set: N 


SBC Aryrin <SEI nn 


Subtract the immediate byte (the second operand) and the carry flag from 
the accumulator. The result is placed in the accumulator. Some Z-80 assem- 
_ blers allow the 8080 mnemonic of SBB to be used as an alternate Z-80 mne- 
monic for this instruction. 


Flags affected: C,H, O,S, Z 


Flag set: N 

SBC HL » BC “no B8080> 
SEC HL. » DE “no 8080> 
SBC HL » HL “no 8080> 
SEC HL » SP kno 8080> 


Subtract the specified CPU double register and the carry flag from the HL 
register pair. The result is placed in HL. You may need to reset the carry 
flag with an OR A operation before using these instructions. 


Flags affected: C, H, O,S, Z 
Flag set: N 


SCF < STC > 


Set the carry flag. There is no equivalent reset command. However, the carry 
flag can be reset with the XOR A instruction, or with the pair of instruc- 
tions SCF and CCF. 


Bit set: C 
Bits reset: H, N 


SET by CHL) “no 8080> 
SET be CIX+dd) “no 8080> 
SET by (I¥ +d) =no 8080> 


Set bit b of the memory byte referenced by the second operand. Bit b can 
range from zero through 7. 


Flag reset: N 
Other flags affected: none 
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SET ber “mo 8080> 
Set bit b of register r. Bit b can range from zero through 7. 


Flag reset: N 
Other flags affected: none 


The following SLA instructions shift bits to the left. 
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carry redister 


SLA CHL) <no 8080> 


Perform an arithmetic shift left on the memory byte pointed to by the HL 
pair. Bit 7 is moved to the carry flag. A zero is moved into bit zero. This 
operation doubles the original value. 


Bits affected: C, P,S, Z 
Bits reset: H, N 


SLA (IX+dd) <no 8080> 
SLA (1Y¥+dd) “no 8080> 


Perform an arithmetic shift left on the memory byte pointed to by the index 
register plus the displacement. Bit 7 is moved to the carry flag. A zero is 
moved into bit zero. This operation doubles the original value. 


Bits affected: C, P,S, Z 
Bits reset: H, N 


SLA r eno 8080> 


Perform an arithmetic shift left on register r. Bit 7 is moved to the carry 
flag. A zero is moved into bit zero. This operation doubles the original value. 
Note: SLA A performs the same task that another instruction ADD A,A 
does, but the former instruction takes twice as long as the latter. 


Bits affected: C, P, S, Z 
Bits reset: H, N 


The following SRA instructions shift bits to the right. 


fies Pe Oe ae ee he Peet 

. : : . ‘ ‘ : ‘ : 

* *, % * sy ~, “, *. ., 1 

rene Coead aoe Se ene ne owen fe me oe — — tren tees Soe ene Hee 

! > ! o a . a a ” “ ” “ ‘ . 
‘ - ‘ . 

I Pm nem fmm Pee Pee Pee Pee eee eee 

: : : : : 3 . : ‘ 


i ! resister carry 
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SRA CHL) «no 8080> 


Perform an arithmetic shift right on the memory byte pointed to by the HL 
pair, Bit zero moves to the carry flag. Bit 7 is duplicated in bit 6. 


Bits affected: C,P,S, Z 
Bits reset: H, N ; 


SRA (IXtdd) . tno B8O080> 
SRA (1Y¥t+dd) <no 8080> 


Perform an arithmetic shift right on the byte pointed to by the index register 


plus the displacement. Bit zero moves to carry and bit 7 is duplicated into 
bit 6. 


Bits affected: C, P, 8S, Z 
Bits reset: H, N 


SRA r “no 8080> 


Perform an arithmetic shift right on register r. Bit zero moves to carry and 
bit 7 is duplicated into bit 6. The operation effectively halves the register 
value. The carry flag represents the remainder. The carry flag is set if the 
original number was odd. 


Bits affected: C, P, S, Z 
Bits reset: H, N 
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The following SRL instructions shift bits to the right. 
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SRL CHL) <no 8080> 


Perform a logical shift right on the byte pointed to by the HL register pair. 
A zero bit is moved into bit 7. Bit zero moves to the carry flag. 


Bits affected: C, P, Z 
Bits reset: H, N,S 


SRL (IX+dd) =<no 8080> 
SRL (1TY¥+dd> <no 8080> 


Perform a logical shift right on the byte pointed to by the index register 
plus the displacement. A zero bit is moved into bit 7. Bit zero moves to the 
carry flag. 
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Bits affected: C, P, Z 
Bits reset: H, N,S 


SRL r <no 8O0B0> 


Perform a logical shift right on register r. A zero bit is moved into bit 7. 
Bit zero moves to the carry flag. 


Bits affected: C,P,S, Z 
Bits reset: H, N 


SUB CHL > <SUB M> 


Subtract the memory byte referenced by the HL pair from the accumulator. 
The result is placed in the accumulator. 


Flags affected: C,H, O, 8S, Z 


Flag set: N 
SUB (1IX+tdd) <no 80807 
SUB (1Y¥+dd) <no 8080. 


Subtract the memory byte referenced by the index register plus the dis- 
placement from the value in the accumulator. The result is placed in A. 


Flags affected: C, H, O,S, Z 
Flag set: N 


SUB r <SUB r> 


Subtract the specified CPU register from the accumulator. The result is 
placed in the accumulator. Notice that Z-80 SUB mnemonic has only one 
operand, whereas there are two operands in the corresponding 8-bit ADC, 
ADD, and SBC mnemonics. The destination operand for all four of these 
instructions is always the accumulator. Consequently, the first operand is 
optional with some assemblers. 


Flags affected: C,H, O, 5S, Z 
Flag:set: N 


SUB nn <SUI min 


Subtract the immediate byte nn from the accumulator. The result is placed 
in the accumulator. 


Flags affected: C, H, O, 8S, Z 
Flag set: N 
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XOR CHL) <XRA Mo 


Perform a logical exclusive OR with the accumulator and the byte referenced 
by the HL pair. The result is placed in the accumulator. 


Flags affected: P,S, Z 
Flags reset: C, H, N 


XOR CIX+dd) <no 8080> 
XOR (1Y+dd) <no 8080> 


Perform a logical exclusive OR with the accumulator and the byte referenced 
by the sum of specified index register and the displacement. The result is 
placed in the accumulator. 


Flags affected: P, S, Z 
Flags reset: C, H, N 


XOR r wXRA rT? 


Perform a logical exclusive OR with the accumulator and register r. The 
result is placed in the accumulator. The XOR A instruction is an efficient 
way to zero the accumulator, although all the flags are then reset. XOR A is 
also used to reset the carry flag. 


Flags affected: P,S, Z 
Flags reset: C,H, N 


XOR nn <XKI "an? 
_ Perform a logical exclusive OR with the accumulator and the byte nn. The 
result is placed in the accumulator. 


Flags affected: P,S, Z 
Flags reset: C, H, N 


APPENDIX I 


Abbreviations and Acronyms 


A/D 
APL 
ASCII 
BCD 
BDOS 
BIOS 
Bit 
BJT 
CBIOS 
CCD 
CCP 
CMOS 
COBOL 
CP/M 
CPU 
CRC 
CRT 
CTS 
D/A 
DCD 
DDT 
DMA 
DOS 
ECL 
EOF 
EPROM 
FCB 
FDOS 
FET 
FIFO 
FORTRAN 
Hz 


Analogue to Digital 

A Programming Language 
American Standard Code for Information Interchange 
Binary-Coded Decimal 

Basic Disk-Operating System (CP/M) 
Basic Input/Output System (CP/M) 
BInary digiT 

Bipolar Junction Transistor 
Customized Bios (CP/M) 
Charge-Coupled Device 

Console Command Processor (CP/M) 
Complementary Metal-Oxide Semiconductor 
COmmon Business-Oriented Language 
Control Program for Microcomputers 
Central Processing Unit 
Cyclical-Redundancy Check 

Cathode Ray Tube 

Clear To Send 

Digital to Analogue 

Data-Carrier Detect 

Dynamic Debugging Tool (CP/M) 
Direct Memory Access 

Disk-Operating System 
Emitter-Coupled Logic 

End Of File 

Erasable PROM 

File Control Block (CP/M) 

Full DOS (CP/M) 

Field-Effect Transistor 

First-In, First-Out 

FORmula TRANSslation 

Hertz (cycles per second) 

Integrated Circuit 

Insulated-Gate FET 
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IIL 
I/O 
JFET 
LCD 
LED 
LIFO 
LSB 
LSI 
MHz 
MODEM 
MOS 
MOSFET 
MSB 
NAND 
NOR 
OP AMP 
PIP 
PPL 
PROM 
PSW 
R/W 
RAM 
ROM 
RTS 
SCR 
SID 
TPA 
TTL 
TTY 
UART 
UJT 
XOR 


Integrated Injection Logic 
Input/Output 

Junction FET 

Liquid Crystal Display 
Light-Emitting Diode 

Last-In, First-Out 
Least-Significant Bit (or Byte) 
Large-Scale Integration 
Megahertz (million Hz) 
MODulator/DEModulator 
Metal-Oxide Semiconductor 
MOS FET 

Most Significant Bit (or Byte) 
Not AND 

Not OR 

OPerational AMPlifier 
Peripheral Interchange Program (CP/M) 
Phase-Locked Loop 
Programmable ROM 
Program-Status Word 
Read/Write 

Random-Access Memory 
Read-Only Memory 

Request To Send 
Silicon-Controlled Rectifier 
Symbolic Instruction Debugger (CP/M) 
Transient Program Area (CP/M) 
Transistor-Transistor Logic 
Teletype 

Universal Asynchronous Receiver/Transmitter 
UniJunction Transistor 
Exclusive OR 


APPENDIX J 


Undocumented 
Z-80 Instructions 


The Z-80 CPU contains two 16-bit index registers called IX and IY. All of 
the official Zilog instructions which refer to IX and IY are 16-bit operations. 
For example, the IX register can be assigned the constant value 1234 with 
the LD instruction 


Lo IX»1234H 


And the contents of the IY register can be saved on the stack with a PUSH | 7 
operation. 


FUSH IY 


A perusal of the numerically ordered Z-80 instructions, given in Appendix F, 
reveals that sequences beginning with the byte DD hex refer to operations 
involving the IX register. Similarly, the byte FD hex signifies an IY operation. 

In addition to the 16-bit operations, there are many 8-bit operations 
that can be performed with the Z-80 index registers. These instructions are 
not shown in Appendix F because they have not been officially documented 
by Zilog. All of these 8-bit IX and IY instructions follow the same pattern. 
The first byte of the IX operation codes is DD hex and the first byte of the 
IY operation codes is FD hex. The remaining byte of the instruction is a 
regular Z-80 operation which refers to the H or L register. But, in this case, 
H now refers to the high 8 bits of the index register and L refers to the low 
8 bits. 

As an example, consider the Z-80 instruction: 


LIt H»B 


which moves the byte in register B into the H register. If this operation code 
is preceded by a DD hex byte, then the B register is moved into the high 
8 bits of the IX register. An assembler that incorporated these undocumented 
- instructions might generate the following source code. 


60 LO Hy B sMOVE B TO H 

DLN6O LD XHoB *>MOVE B TO HIGH IX 
lO6R LD XLeE sMOVE E TO LOW Ix 
FLG?7 Lo YHoA §MOVE A TO HIGH IY 
FOG? LD YLeC sMOVE C TO LOW IY 
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But, except for Allen Ashley’s PDS assembler, these XH, XL, YH, and YL 
symbols have not actually been incorporated into Z-80 assemblers. The 

~undocumented instructions encompass all of the 8-bit LD op codes involv- 
ing the H and L registers. These include the register-to-register moves 


LO Hor 
LO Ler 
LO rrH 
Lo rel 


- where r is one of the general-purpose registers A, B, C, D, and E. The in- 
structions 


LI LeH and 
LD. Hel 


are also included. In this case the H and L refer respectively to the high 
8 bits and the low 8 bits of the same index register. Thus, the instruction 


LO LeH 


preceded by a DD byte will move the high 8 bits of the IX register into the 
low 8 bits. The regular H and L registers cannot be operands for these moves. 
Move-immediate instructions are not included in the new instructions. 
Furthermore, 8-bit transfers cannot be made from one index register to the 
other. 

Many of the other 8-bit register operations can be utilized in this way. 
In addition to the above LD instructions, these include the following. 


Anc ArH ALC Ack 
ALD ArH Ant AsL 
‘AND H ANI L 
CF H Cr L. 
HEC H DEC L 
INC H INC L 
OR H OR L. 
SBC AvH SRC Agvk 
SUB H SUB L. 
XOR H XOR L. 


The rotations and shifts, the bit manipulations that set, reset and test, and 
the input and output operations are not included. 

All of these undocumented operations can be produced with a regular 
Z-80 assembler. One method is to generate the initial DD or FD hex with 
the DEFB directive. Then, the corresponding regular Z-80 instruction fol- 
lows. For example, the following two lines will generate the instruction 
- needed to move the accumulator into the high half of IX. 


DEFER ODDH *SET FOR IX 
Lt HA sMOVE A TO XH 
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Alternately, a macro can be used. The definition could be 


LOX MACRO REG1»REG2 
NEFB ODTIH 
LD REG1»REG2 
ENIM 


Then the macro call 
Lx H»A 


will generate the desired code. 


Index 


Accumulator, 3 
Acoustical coupler, 65 
Acronyms, 311 
Active high, 93 
Analog-to-digital, 188 
Arithmetic shift, 76, 155, 180, 307 
ASCII, 20, 66, 150 
character set, 253 
Assembler, 2, 86 
Autostart tape, 201 


Base conversion, 150 

BCD, 19, 168 

Binary, 17 

Binary coded decimal, 19, 168 
BIOS (CP/M), 91, 216 

Block move, 18, 111, 297 
Branch table, 107 

Buffered input, 55 

Bus, 1 


Carry flag, 5,10 
Checksum, 68, 188 
Clock routine, 241 
Code, operation, 1 
Cold start, 103 
Compare 7, 123 
Complement, 21 
Concatination, 72 
Conditional branch, 12, 287, 293 
Control character, 93, 99, 100 
Conversion, number base, 150 
CP/M, 51, 86, 91, 123, 175, 201, 214 
CPU, 1 
Crazy octal, 164, 182 
Cross reference 
8080 to Z-80, 280 
Z-80 to 8080, 283 


DAA, 179 

Data port, 49 

Data ready, 91 

Debugger, 94 

Decimal adjust accumulator, 179 
Decrement, 8, 10 


Delay, after carriage return, 148 
Delimiter, 151 

De Morgan’s theorem, 28 
Digital-to-analog, 188 
Directive, 87 

DOS, 214 

Double precision arithmetic, 22, 180 
Double register, 3, 10,13 
Doubling, 15, 155, 307 
Dummy variable, 70 

Dump, memory, 95 


Echo, 95 
Editor, 86, 143 
Exclusive OR, 26 


FCB (CP/M), 226, 242 
File control block, 226, 242 
Filename, 204 
Fixed entry, 152 
Flags, 3, 6, 10 
I/O, 50, 71, 93 
Free entry, 152 
Full duplex, 65 
Function number (CP/M), 216 


Gates, 21 
GO program, 226 


Halving, 15 

Handshake, 49 

Hex arithmetic, 119 

Hex format, 201 
Hexadecimal numbers, 17 
High-level language, 2, 214 


Increment, 8, 10 

Index register, 313 

Input, 14, 48, 117, 146 

Instruction set 
alphabetic, 8080, 258 
alphabetic, Z-80, 264 
numeric, 8080, 261 
numeric, Z-80, 272 
details, 283 


317 


318 INDEX 


Intel hex format, 201 
Interrupt-driven keyboard, 55 
‘Interrupt register, 11 
Interrupts, 52 

IOBYTE (CP/M), 217, 220 


Jump, relative, 12, 144 


Label, 2 

local, 82 
Labels, readable, 203 
Leading-zero suppression, 173 
LIFO stack, 30 
List routine, 229 
Loader routine, 125 
Logical AND, 23, 224 
Logical devices, 215 
Logical exclusive OR, 26 
Logical operations, 7, 20 
Logical OR, 23 
Logical shift, 15 
Looping, 50 


Macros, 69, 143 
Magnetic tape, 187 
Masking AND, 25, 50, 178, 220 
Memory allocation (CP/M), 217 
Memory 

map, 255 

pointer, 2, 55,113 

test, 120 
Memory-mapped port, 48 
Mnemonic, 2 
Modem, 64 
Monitor, 85, 128 
Movement of data, 111 
Multiplication, 15, 157 


NAND gate, 26 
Nibble, 178 
NOR gate, 26 
Nulls, carriage return, 
77,938, 219 
Number-base conversion, 150 


Object program, 2 
Octal, 16, 163, 180 
Offset, 202 

One’s complement, 21 
Opcode, 1 
Operand, 2 

Operation code, 1 


Output, 14, 48, 71, 117, 146, 215 


Packed BCD, 19, 168 
Page, memory, 105 
Paper tape, 187 
Parallel port, 49 
Parity, 66 
Passing data, 37, 39 
Peripheral, 1, 14 
port, 48, 117, 146 
Physical devices, 218 
PIP (CP/M), 143, 230 
Pointer, 2,12, 55 


Polling, 52 

POP, 31 

Port, I/O, 48, 117, 146 
initialization, 146 

Printer routine, 147 

Program counter, 3, 11, 36 

Program status word, 3, 34 

PSW, 3, 34 

PUSH, 31 


Register 
flag, 3 
memory, 5 
refresh, 11 
saving, 33 
status, 2 
Register pair, 3 
Registers 
8080, 3 
Z-80, 11 
Relative jump, 12, 144 
Resetting a bit, 25 
Rotation, 9 
RST instruction, 53 


Scroll, 64, 99 
Searching, 118,115 
Serial port, 49 
Setting a bit, 24 
Shift, 14, 76, 155, 307 
Signed number, 6, 15 
Source program, 2, 214 
Split octal, 164, 182 
Spooling, 52 
Stack, 30 
automatic placement, 45 
saving registers on, 33 
setting up new, 40 
storing data on, 31 
Stack pointer, 31, 109 
STAT (CP/M), 225 
Status port, 49 
String, 150 
Subroutine call, 35, 287 
Subtraction, 22, 177 


Table, command branch, 107 

Tape recording, 187 

Tape, test, 212 

Telephone modem, 64 

Top-down method, 85 

Truth table, 21 

Two’s complement, 21, 74, 75,177, 201 


Unconditional branch, 12 
Undocumented Z-80 instructions, 313 
Unsigned number, 6 


Vectors, 103, 219 
Vectored interrupt, 53 


Warm start, 103 


Z-80 instruction macros, 73 
Z-80 registers, 11 
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More than two million people have learned to program, use, and enjoy 
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More TRS-80® BASIC, Inman, Zamora, & Albrecht 

PC DOS: Using the IBM PC Operating System, Ashley & Fernandez 
Structured COBOL, Ashley 

Subroutine Sandwich, Grillo & Robertson 

Successful Software for Small Computers, Beech 

Timex Sinclair 2000 Explored, Hartnell 

TRS-80® BASIC, Albrecht, Inman & Zamora 

TRS-80® Color Basic, Albrecht 

TRS-80® Means Business, Lewis 

UNIX™ Operating System Book, Banahan & Rutter 

Using VisiCalc®: Getting Down to Business, Klitzner & Plociak 
What Can I Do with My Timex Sinclair? Lots!, Valentine 
Why Do You Need a Personal Computer? Leventhal & Stafford 
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